algvex-web

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Algvex Website Management

Algvex网站管理

Web interface for AItrader trading system at algvex.com.

AItrader交易系统的网页界面，网址为algvex.com。

Architecture

架构

                    Caddy (HTTPS)
                    algvex.com:443
                        │
            ┌───────────┴───────────┐
            │                       │
        Frontend                Backend
        (Next.js)              (FastAPI)
      localhost:3000         localhost:8000

                    Caddy (HTTPS)
                    algvex.com:443
                        │
            ┌───────────┴───────────┐
            │                       │
        Frontend                Backend
        (Next.js)              (FastAPI)
      localhost:3000         localhost:8000

Key Information

关键信息

Item	Value
Domain	algvex.com
Server	139.180.157.152
Frontend	Next.js 14 + TypeScript
Backend	FastAPI + Python 3.12
Database	SQLite
Auth	Google OAuth
Install Path	/home/linuxuser/algvex

项目	取值
域名	algvex.com
服务器	139.180.157.152
前端	Next.js 14 + TypeScript
后端	FastAPI + Python 3.12
数据库	SQLite
身份验证	Google OAuth
安装路径	/home/linuxuser/algvex

Directory Structure

目录结构

/home/linuxuser/algvex/
├── backend/           # FastAPI backend
│   ├── main.py
│   ├── .env           # Configuration
│   └── algvex.db      # SQLite database
├── frontend/          # Next.js frontend
│   ├── .next/         # Build output
│   └── pages/         # Page components
└── deploy/            # Deployment configs

/home/linuxuser/algvex/
├── backend/           # FastAPI后端
│   ├── main.py
│   ├── .env           # 配置文件
│   └── algvex.db      # SQLite数据库
├── frontend/          # Next.js前端
│   ├── .next/         # 构建输出
│   └── pages/         # 页面组件
└── deploy/            # 部署配置文件

Deployment Commands

部署命令

Full Deployment

完整部署

bash

cd /home/linuxuser/nautilus_AItrader/web/deploy
chmod +x setup.sh
./setup.sh

bash

cd /home/linuxuser/nautilus_AItrader/web/deploy
chmod +x setup.sh
./setup.sh

Restart Services

重启服务

bash

sudo systemctl restart algvex-backend algvex-frontend caddy

bash

sudo systemctl restart algvex-backend algvex-frontend caddy

Check Status

查看状态

bash

sudo systemctl status algvex-backend
sudo systemctl status algvex-frontend
sudo systemctl status caddy

bash

sudo systemctl status algvex-backend
sudo systemctl status algvex-frontend
sudo systemctl status caddy

View Logs

查看日志

bash

undefined

bash

undefined

Backend logs

后端日志

sudo journalctl -u algvex-backend -f

Frontend logs

前端日志

sudo journalctl -u algvex-frontend -f

Caddy logs

Caddy日志

sudo journalctl -u caddy -f

undefined

sudo journalctl -u caddy -f

undefined

Configuration

配置

Backend Environment (/home/linuxuser/algvex/backend/.env)

后端环境变量（/home/linuxuser/algvex/backend/.env）

bash

undefined

bash

undefined

Required

必填项

SECRET_KEY=your-secure-key GOOGLE_CLIENT_ID=your-client-id.apps.googleusercontent.com GOOGLE_CLIENT_SECRET=your-client-secret ADMIN_EMAILS=your-email@gmail.com

AItrader Integration

AItrader集成配置

AITRADER_PATH=/home/linuxuser/nautilus_AItrader AITRADER_CONFIG_PATH=/home/linuxuser/nautilus_AItrader/configs/base.yaml AITRADER_SERVICE_NAME=nautilus-trader

undefined

AITRADER_PATH=/home/linuxuser/nautilus_AItrader AITRADER_CONFIG_PATH=/home/linuxuser/nautilus_AItrader/configs/base.yaml AITRADER_SERVICE_NAME=nautilus-trader

undefined

Google OAuth Setup

Google OAuth设置

Go to https://console.cloud.google.com/apis/credentials
Create OAuth 2.0 Client ID

Add redirect URI:

https://algvex.com/api/auth/callback/google

Copy credentials to
```
.env
```

访问https://console.cloud.google.com/apis/credentials
创建OAuth 2.0客户端ID

添加重定向URI：

https://algvex.com/api/auth/callback/google

将凭据复制到
```
.env
```
文件中

API Endpoints

API端点

Public (No Auth)

公开接口（无需身份验证）

Endpoint	Description
`/api/public/performance`	Trading stats
`/api/public/social-links`	Social links
`/api/public/copy-trading`	Copy trading links
`/api/public/system-status`	Bot status

端点	描述
`/api/public/performance`	交易统计数据
`/api/public/social-links`	社交链接
`/api/public/copy-trading`	跟单交易链接
`/api/public/system-status`	机器人状态

Admin (Auth Required)

管理员接口（需身份验证）

Endpoint	Description
`/api/admin/config`	Strategy config
`/api/admin/service/control`	Service control
`/api/admin/social-links/*`	Manage links

端点	描述
`/api/admin/config`	策略配置
`/api/admin/service/control`	服务控制
`/api/admin/social-links/*`	管理链接

Caddy Configuration

Caddy配置

Located at

/etc/caddy/Caddyfile

algvex.com {
    handle /api/* {
        reverse_proxy localhost:8000
    }
    handle {
        reverse_proxy localhost:3000
    }
}

位于

/etc/caddy/Caddyfile

：

algvex.com {
    handle /api/* {
        reverse_proxy localhost:8000
    }
    handle {
        reverse_proxy localhost:3000
    }
}

Common Issues

常见问题

Issue	Solution
HTTPS not working	Check DNS, wait for Let's Encrypt
502 Bad Gateway	Restart backend/frontend services
OAuth callback error	Verify redirect URI in Google Console
Config not updating	Restart algvex-backend

问题	解决方案
HTTPS无法正常工作	检查DNS配置，等待Let's Encrypt证书生效
502网关错误	重启后端/前端服务
OAuth回调错误	在Google控制台验证重定向URI
配置未生效	重启algvex-backend服务

Key Files

关键文件

File	Purpose
`web/backend/main.py`	Backend entry point
`web/frontend/pages/index.tsx`	Homepage
`web/frontend/pages/admin/index.tsx`	Admin panel
`web/deploy/Caddyfile`	Reverse proxy config
`web/deploy/setup.sh`	Deployment script

文件	用途
`web/backend/main.py`	后端入口文件
`web/frontend/pages/index.tsx`	首页
`web/frontend/pages/admin/index.tsx`	管理面板
`web/deploy/Caddyfile`	反向代理配置
`web/deploy/setup.sh`	部署脚本