当前位置: 首页 > news >正文

NOFX AI量化交易系统 - 完整使用手册


📖 目录

  • 第一部分:系统概述

  • 第二部分:环境准备

  • 第三部分:快速部署

  • 第四部分:Web界面操作

  • 第五部分:交易员管理

  • 第六部分:监控与分析

  • 第七部分:高级配置

  • 第八部分:故障排查

  • 第九部分:最佳实践

  • 第十部分:常见问题FAQ


第一部分:系统概述

1.1 NOFX是什么?

NOFX是一个基于人工智能的加密货币自动交易系统,它能够:

  • 24小时自动监控市场:无需人工盯盘

  • AI智能决策:使用DeepSeek、Qwen等大语言模型分析市场

  • 多交易所支持:币安、Hyperliquid、Aster DEX

  • 风险自动控制:内置止损、仓位限制、保证金管理

  • 完整决策记录:每笔交易都有详细的AI思维链日志

  • 实时可视化监控:专业的Web仪表盘

1.2 系统架构简图

┌─────────────────────────────────────────────────────────┐
│                     用户(你)                           │
│                        ↓                                │
│              Web浏览器 (http://localhost:3000)          │
└─────────────────────────────────────────────────────────┘↓
┌─────────────────────────────────────────────────────────┐
│                  NOFX 核心系统                          │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  │
│  │ 配置管理     │  │ AI决策引擎   │  │ 交易执行器   │  │
│  └──────────────┘  └──────────────┘  └──────────────┘  │
└─────────────────────────────────────────────────────────┘↓                    ↓                    ↓
┌──────────────┐    ┌──────────────┐    ┌──────────────┐
│   SQLite     │    │  AI API      │    │ 交易所 API   │
│   数据库     │    │  (DeepSeek)  │    │  (Binance)   │
└──────────────┘    └──────────────┘    └──────────────┘

1.3 核心工作流程

1. 系统启动↓
2. 加载配置(AI模型、交易所、交易员)↓
3. 定时触发(每3-5分钟)↓
4. 获取市场数据(价格、K线、技术指标、持仓量)↓
5. 查询当前账户状态(余额、持仓、盈亏)↓
6. 分析历史表现(最近20笔交易的胜率、盈亏比)↓
7. 生成AI提示词(包含所有上下文信息)↓
8. 调用AI API获取决策↓
9. 解析AI返回的交易指令↓
10. 风险验证(仓位限制、风险回报比、保证金检查)↓
11. 执行交易(下单到交易所)↓
12. 记录日志(保存到decision_logs目录和数据库)↓
13. 等待下一个周期

第二部分:环境准备

2.1 硬件要求

最低配置:

  • CPU: 双核 2.0GHz

  • 内存: 2GB RAM

  • 存储: 10GB 可用空间

  • 网络: 稳定的互联网连接

推荐配置:

  • CPU: 四核 2.5GHz+

  • 内存: 4GB RAM

  • 存储: 20GB SSD

  • 网络: 5Mbps+ 带宽

2.2 软件依赖

方式一:Docker部署(强烈推荐)

只需要安装Docker:

Windows/macOS:

  1. 访问 Docker Desktop官网

  2. 下载对应系统的安装包

  3. 双击安装,一路"下一步"

  4. 重启计算机

Linux (Ubuntu/Debian):

# 使用官方安装脚本
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh# 将当前用户加入docker组
sudo usermod -aG docker $USER
newgrp docker

验证安装:

docker --version
# 应该显示:Docker version 24.x.xdocker compose version
# 应该显示:Docker Compose version v2.x.x
方式二:手动部署(开发者)

如果你想修改代码或深度定制,需要手动安装:

1. 安装 Go (1.21+)

# Linux
wget https://go.dev/dl/go1.21.0.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.21.0.linux-amd64.tar.gz
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
source ~/.bashrc# macOS
brew install go# Windows: 下载安装包
# https://go.dev/dl/

2. 安装 Node.js (18+)

# Linux/macOS (使用nvm)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 18
nvm use 18# Windows: 下载安装包
# https://nodejs.org/

3. 安装 TA-Lib

# macOS
brew install ta-lib# Ubuntu/Debian
sudo apt-get update
sudo apt-get install libta-lib0-dev# Windows: 下载预编译包
# https://github.com/markcheno/go-talib

2.3 账户准备

(1)币安账户(必需)

步骤:

  1. 注册账户

    • 访问:https://www.binance.com/join?ref=TINKLEVIP

    • 使用邮箱或手机号注册

    • 完成邮箱/手机验证

  2. 完成KYC认证

    • 进入"用户中心" → "身份认证"

    • 上传身份证/护照

    • 人脸识别验证

    • 等待审核(通常1-24小时)

  3. 开通合约交易

    • 访问"衍生品" → "U本位合约"

    • 点击"立即开通"

    • 阅读并同意风险协议

  4. 创建API密钥

    • 进入"用户中心" → "API管理"

    • 点击"创建API"

    • 输入标签名称(如:NOFX_Trading)

    • 重要:只勾选"启用合约交易",不要勾选"提现"

    • 完成二次验证

    • 立即保存API Key和Secret Key(只显示一次!)

  5. 绑定IP白名单(强烈推荐)

    • 在API管理页面,找到刚创建的API

    • 点击"编辑"

    • 添加你的服务器IP(如果是本地测试,添加你的公网IP)

    • 保存

资金准备:

  • 测试阶段:建议100-500 USDT

  • 正式运行:建议500-2000 USDT

  • ⚠️ 切记:只投入你能承受损失的资金

(2)AI API密钥(必需)

推荐:DeepSeek(性价比最高)

  1. 访问:https://platform.deepseek.com

  2. 使用邮箱注册

  3. 进入"余额充值",充值$20-50(推荐)

  4. 进入"API Keys",点击"创建新密钥"

  5. 立即复制保存密钥(格式:sk-xxxxxxxxxxxxxxxxxx

费用参考:

  • 价格:$0.14 / 百万tokens

  • 日消耗:约$1-2(24小时运行,3分钟决策间隔)

  • $50可用约1个月

备选:通义千问 Qwen

  1. 访问:https://dashscope.console.aliyun.com

  2. 使用阿里云账号登录(需要中国手机号)

  3. 开通"DashScope"服务

  4. 创建API密钥


第三部分:快速部署

3.1 下载项目

# 使用Git克隆
git clone https://github.com/tinkle-community/nofx.git
cd nofx# 或者直接下载ZIP(Windows用户推荐)
# 访问 https://github.com/tinkle-community/nofx
# 点击 "Code" → "Download ZIP"
# 解压到任意目录

3.2 配置系统

步骤1:创建配置文件
# 复制配置模板
cp config.example.jsonc config.json
步骤2:编辑配置文件

Windows用户:

notepad config.json

macOS/Linux用户:

nano config.json
# 或者使用你喜欢的编辑器:vim, code, etc.
步骤3:填写基础配置

最简配置示例:

{"admin_mode": true,"use_default_coins": true,"api_server_port": 8080,"jwt_secret": "请把这里替换成一个至少32位的随机字符串","leverage": {"btc_eth_leverage": 5,"altcoin_leverage": 5}
}

生成随机JWT密钥:

# macOS/Linux
openssl rand -base64 64# Windows PowerShell
[Convert]::ToBase64String((1..64 | ForEach-Object { Get-Random -Minimum 0 -Maximum 256 }))# 或者使用在线工具
# https://www.grc.com/passwords.htm

配置项说明:

配置项说明推荐值
admin_mode管理员模式(简化登录)true
use_default_coins使用默认币种列表true
api_server_portAPI服务端口8080
jwt_secretJWT密钥(必须修改)64位随机字符串
btc_eth_leverageBTC/ETH最大杠杆5(保守)
altcoin_leverage山寨币最大杠杆5(保守)

⚠️ 重要提醒:

  • jwt_secret 必须修改为你自己的随机字符串

  • 币安子账户杠杆最高只能5倍

  • 主账户可以设置更高,但新手不推荐

3.3 启动系统

使用Docker(推荐)
# 首次启动(会自动构建镜像)
docker compose up -d --build# 查看启动状态
docker compose ps# 查看日志
docker compose logs -f# 停止系统
docker compose down# 重启系统
docker compose restart

启动成功标志:

✅ Container nofx-trading       Started
✅ Container nofx-frontend      Started
使用手动部署

终端1:启动后端

# 安装Go依赖
go mod download# 编译程序
go build -o nofx# 启动后端
./nofx

终端2:启动前端

# 进入前端目录
cd web# 安装依赖(首次运行)
npm install# 启动开发服务器
npm run dev

3.4 访问系统

打开浏览器,访问:

http://localhost:3000

首次登录凭证(管理员模式):

  • 用户名:admin

  • 密码:admin123

⚠️ 安全提示:生产环境必须立即修改密码!


第四部分:Web界面操作

4.1 登录系统

  1. 打开 http://localhost:3000

  2. 输入用户名和密码

  3. 点击"登录"按钮

界面语言切换:

  • 右上角有语言切换按钮

  • 支持:中文、English

4.2 主界面导航

┌─────────────────────────────────────────────────────────┐
│  [NOFX Logo]  [竞赛页] [交易员管理] [语言] [退出]       │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  主要内容区域                                            │
│  - 竞赛页:多AI对比排行榜                                │
│  - 交易员管理:配置、启动、监控交易员                     │
│                                                         │
└─────────────────────────────────────────────────────────┘

4.3 配置AI模型

步骤:

  1. 进入"交易员管理"页面

  2. 点击"AI模型配置"按钮

  3. 启用DeepSeek或Qwen

配置DeepSeek:

AI模型名称: DeepSeek
API密钥: sk-your-deepseek-api-key-here
自定义API地址: (留空,使用默认)
自定义模型名称: (留空,使用默认)
状态: ✅ 启用

配置Qwen:

AI模型名称: Qwen
API密钥: sk-your-qwen-api-key-here
自定义API地址: (留空,使用默认)
自定义模型名称: (留空,使用默认)
状态: ✅ 启用
  1. 点击"保存配置"

验证成功标志:

  • 看到"配置保存成功"提示

  • AI模型列表中状态显示为"已启用"

4.4 配置交易所

步骤:

  1. 在"交易员管理"页面

  2. 点击"交易所配置"按钮

  3. 选择Binance

配置Binance:

交易所名称: Binance
API Key: your-binance-api-key
Secret Key: your-binance-secret-key
状态: ✅ 启用
  1. 点击"保存配置"

验证连接:

  • 系统会自动测试连接

  • 成功后显示"连接成功"

  • 失败会显示错误信息(检查API密钥是否正确)


第五部分:交易员管理

5.1 创建交易员

步骤:

  1. 进入"交易员管理"页面

  2. 点击"创建交易员"按钮

  3. 填写以下信息:

交易员名称: 稳健策略A(自己命名,便于识别)
AI模型: DeepSeek(从下拉列表选择已配置的模型)
交易所: Binance(从下拉列表选择已配置的交易所)
初始余额: 500(填写你在币安账户的实际USDT余额)
扫描间隔: 3分钟(推荐3-5分钟)
自定义策略: (可选,留空使用默认策略)
  1. 点击"创建"按钮

命名建议:

  • 描述性命名:如"DeepSeek-保守-5倍杠杆"

  • 包含策略特点:如"Qwen-激进-主流币"

  • 方便多交易员对比

5.2 启动交易员

步骤:

  1. 在交易员列表中找到你创建的交易员

  2. 点击"启动"按钮

  3. 确认弹窗中点击"确定"

启动成功标志:

  • 状态变为"运行中"(绿色)

  • 显示运行时长倒计时

  • 开始出现决策记录

首次决策时间:

  • 通常需要等待3-5分钟(一个扫描周期)

  • 首次决策可能显示"观望"(正常现象)

  • AI需要先分析市场环境

5.3 停止交易员

步骤:

  1. 找到正在运行的交易员

  2. 点击"停止"按钮

  3. 确认弹窗中点击"确定"

停止后行为:

  • ✅ 已有持仓保持不变(不会自动平仓)

  • ✅ 不再产生新的决策

  • ✅ 可以随时重新启动

  • ⚠️ 如需平仓,请在交易所手动操作或使用"一键平仓"功能

5.4 删除交易员

步骤:

  1. 确保交易员已停止

  2. 点击"删除"按钮

  3. 确认弹窗中输入交易员名称

  4. 点击"确定"

⚠️ 警告:

  • 删除后无法恢复

  • 决策日志会保留在decision_logs目录

  • 但数据库中的权益历史会被清除

5.5 批量操作

一键启动所有交易员:

点击页面顶部的"启动全部"按钮

一键停止所有交易员:

点击页面顶部的"停止全部"按钮

第六部分:监控与分析

6.1 实时监控面板

账户信息卡片:

┌────────────────────────────────────┐
│ 账户概览                           │
├────────────────────────────────────┤
│ 总权益:     1,250.00 USDT         │
│ 可用余额:     800.50 USDT         │
│ 总盈亏:      +25.00% (+250 USDT)  │
│ 保证金使用率: 45.2%                │
│ 持仓数量:     2                    │
└────────────────────────────────────┘

字段解释:

  • 总权益:账户总价值 = 可用余额 + 已用保证金 + 未实现盈亏

  • 可用余额:可以用来开新仓的资金

  • 总盈亏:相对初始余额的收益率

  • 保证金使用率:已用保证金 / 总权益(超过90%会限制开仓)

  • 持仓数量:当前持有的仓位个数

6.2 持仓列表

示例:

┌─────────────────────────────────────────────────────────────┐
│ 当前持仓 (2)                                                 │
├─────────────────────────────────────────────────────────────┤
│ BTCUSDT  LONG  5x                                           │
│ 入场价: 96,500.00 | 当前价: 97,200.00 | 盈亏: +0.73%        │
│ 仓位: 2,500 USDT | 保证金: 500 USDT | 强平价: 94,000       │
│ 持仓时长: 2小时15分钟                                        │
│ [平仓] [修改止损止盈]                                        │
├─────────────────────────────────────────────────────────────┤
│ ETHUSDT  SHORT  5x                                          │
│ 入场价: 3,500.00 | 当前价: 3,480.00 | 盈亏: +0.57%         │
│ 仓位: 1,500 USDT | 保证金: 300 USDT | 强平价: 3,900        │
│ 持仓时长: 45分钟                                             │
│ [平仓] [修改止损止盈]                                        │
└─────────────────────────────────────────────────────────────┘

颜色标识:

  • 🟢 绿色:盈利持仓

  • 🔴 红色:亏损持仓

  • 🟡 黄色:接近强平价(警告)

6.3 权益曲线图

功能:

  • 📈 显示账户价值随时间的变化

  • 🔄 可切换"绝对值"和"百分比"视图

  • 🔍 鼠标悬停查看具体数值

  • 📅 支持时间范围筛选(1天/7天/30天/全部)

分析技巧:

  1. 平滑上升:策略稳健,风险控制良好

  2. 剧烈波动:杠杆过高或仓位管理不当

  3. 持续下跌:市场环境不适合,考虑暂停

  4. 台阶式上升:抓住了几次好机会,但频率不高

6.4 AI决策日志

查看方法:

  1. 进入"交易员详情"页面

  2. 滚动到"AI决策日志"区域

  3. 点击任意决策记录的"展开"按钮

日志内容:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
决策时间: 2025-11-03 14:32:15
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━【输入数据】
时间: 2025-11-03 14:32 | 周期: #47 | 运行: 142分钟BTC: 96,500.00 (1h: +0.8%, 4h: +2.3%) | MACD: 125.34 | RSI: 58.2账户: 净值1,250.00 | 余额800.50 (64.0%) | 盈亏+25.0% | 保证金45.2% | 持仓2个## 当前持仓
1. BTCUSDT LONG | 入场价96,500 当前价96,800 | 盈亏+0.31% | 杠杆5x | 保证金500 | 强平价94,000 | 持仓时长2小时15分钟[市场数据详情...]━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━【AI分析思维链】市场环境分析:
BTC在96,500附近形成支撑,4小时级别呈现上升趋势。
MACD保持金叉状态,RSI(58)处于中性偏多区域,未超买。
持仓量稳定增长,显示多头信心较强。现有持仓评估:
BTCUSDT多单已持有2小时,浮盈+0.31%。
虽有盈利但未达到止盈目标(99,000),暂时继续持有。
止损设置在95,000,风险可控。新机会识别:
ETHUSDT在3,500附近遇阻,4小时级别MACD即将死叉。
考虑开设小仓位做空,目标3,400,止损3,600。
风险回报比 (3,500-3,400)/(3,600-3,500) = 1:1 不满足≥1:3要求,放弃。决策结论:
保持现有BTCUSDT多单,暂不开新仓。━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━【决策输出】
[{"symbol": "BTCUSDT","action": "hold","reasoning": "持续观察,等待止盈或止损触发"}
]━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━【执行结果】
✅ 决策执行成功
操作: 保持持仓
无新订单生成

日志解读要点:

  1. 输入数据:AI看到了什么信息

  2. 思维链:AI如何分析市场(最重要)

  3. 决策输出:AI最终的指令

  4. 执行结果:系统是否成功执行

6.5 统计数据

关键指标:

┌────────────────────────────────────┐
│ 交易统计                           │
├────────────────────────────────────┤
│ 总决策周期:  150                   │
│ 开仓次数:     32                   │
│ 平仓次数:     28                   │
│ 胜率:        57.1% (16胜12负)      │
│ 平均盈利:    +2.8%                 │
│ 平均亏损:    -1.5%                 │
│ 盈亏比:      1.87:1                │
│ 夏普比率:    1.42                  │
│ 最大回撤:    -8.3%                 │
└────────────────────────────────────┘

指标说明:

  • 胜率:盈利交易 / 总交易次数

  • 盈亏比:平均盈利 / 平均亏损(>1说明赚得比亏得多)

  • 夏普比率:风险调整后的收益(>1优秀,>2非常优秀)

  • 最大回撤:从峰值到谷底的最大跌幅


第七部分:高级配置

7.1 自定义交易策略

功能说明: 你可以为交易员添加个性化策略指令,系统会将其追加到AI的Prompt中。

配置方法:

  1. 进入"交易员详情"页面

  2. 点击"编辑策略"按钮

  3. 在文本框中输入你的策略描述

示例1:保守策略

个性化策略:
1. 优先交易BTC和ETH,山寨币仅在极强趋势时参与
2. 单笔交易杠杆不超过3倍
3. 震荡市(BTC日内波动<2%)降低交易频率
4. 连续亏损2笔后,暂停1小时再交易
5. 持仓超过4小时未达止盈,考虑提前止盈50%

示例2:激进策略

个性化策略:
1. 积极捕捉短期波动,扫描间隔设为3分钟
2. 可使用5倍杠杆(BTC/ETH)和3倍杠杆(山寨币)
3. 优先做多,但在明确下跌信号时果断做空
4. 关注持仓量急速变化的币种(OI Top信号)
5. 单笔盈利达到2%立即止盈,不等待更高目标

示例3:趋势跟踪

个性化策略:
1. 只做趋势,不做震荡:4小时EMA20必须明确方向
2. 严格止损,止损幅度1.5%,止盈幅度≥4.5%(1:3风险回报比)
3. 持仓时间最少6小时,给趋势充分发展空间
4. 避免在高波动时段(美国收盘、重大新闻)开仓
5. 最多持仓1个币种,集中资金做透一个机会

注意事项:

  • 策略描述要清晰明确,避免模糊表达

  • AI会尽量遵守,但仍会结合市场实际情况调整

  • 不能违背系统的硬约束(如风险回报比≥1:3)

7.2 调整杠杆配置

修改方法:

编辑config.json文件:

{"leverage": {"btc_eth_leverage": 10,    // BTC和ETH最大杠杆"altcoin_leverage": 5      // 山寨币最大杠杆}
}

重启系统生效:

docker compose restart

杠杆建议:

风险偏好BTC/ETH山寨币适合人群
极保守3x2x完全新手
保守5x3x谨慎投资者
平衡10x5x有经验者
激进20x10x专业交易员

⚠️ 警告:

  • 币安子账户最高只能5倍(平台限制)

  • 高杠杆=高风险,可能快速爆仓

  • 建议从保守开始,逐步调整

7.3 自定义币种列表

方法:

编辑config.json

{"use_default_coins": false,"default_coins": ["BTCUSDT","ETHUSDT","SOLUSDT","BNBUSDT","XRPUSDT","ADAUSDT","DOGEUSDT","AVAXUSDT","LINKUSDT","MATICUSDT"]
}

添加币种要求:

  • 必须是币安合约支持的币种

  • 格式必须为 XXXUSDT(大写)

  • 建议选择流动性好的主流币(日交易量>1亿美元)

查看支持的币种:

  1. 访问币安合约官网

  2. 查看"U本位合约"列表

  3. 确认币种代码

7.4 配置扫描间隔

修改方法:

在创建交易员时设置,或通过Web界面编辑:

扫描间隔选项:
- 3分钟:激进策略,捕捉短期波动(AI调用费用较高)
- 5分钟:平衡策略,适合大多数情况(推荐)
- 10分钟:保守策略,适合趋势跟踪
- 15分钟:极保守策略,适合长期持有

费用对比:

  • 3分钟:每天480次决策,AI费用约$2-3

  • 5分钟:每天288次决策,AI费用约$1.5-2

  • 10分钟:每天144次决策,AI费用约$0.8-1

7.5 风险控制参数

编辑config.json

{"max_daily_loss": 10.0,        // 单日最大亏损百分比(触发后暂停)"max_drawdown": 20.0,          // 最大回撤百分比(触发后暂停)"stop_trading_minutes": 360    // 触发风控后暂停时长(分钟)
}

参数说明:

  • max_daily_loss:当天亏损超过此比例,自动停止交易

  • max_drawdown:从最高点回撤超过此比例,自动停止

  • stop_trading_minutes:风控触发后的冷静期(6小时=360分钟)

7.6 多交易所配置

配置Hyperliquid(去中心化):

  1. 导出MetaMask私钥(移除0x前缀)

  2. Web界面"交易所配置"选择Hyperliquid

  3. 填写:

交易所名称: Hyperliquid
钱包地址: 你的ETH钱包地址
私钥: 私钥(不含0x前缀)
测试网: false(勾选则使用测试网)

配置Aster DEX:

  1. 访问 Aster API Wallet

  2. 创建API钱包,获取Signer地址和私钥

  3. Web界面配置:

交易所名称: Aster
用户钱包: 你的主钱包地址
Signer地址: API钱包地址
私钥: API钱包私钥(不含0x前缀)

第八部分:故障排查

8.1 常见错误及解决方案

问题1:Docker启动失败

错误信息:

Error: Cannot connect to the Docker daemon

解决方法:

# 检查Docker是否运行
docker ps# 启动Docker服务(Linux)
sudo systemctl start docker# Windows/Mac:打开Docker Desktop应用
问题2:端口被占用

错误信息:

Error: Port 8080 is already in use

解决方法:

方法1:修改端口

// 编辑config.json
{"api_server_port": 8081  // 改为其他端口
}

方法2:释放占用端口

# Windows
netstat -ano | findstr :8080
taskkill /PID <进程ID> /F# Linux/Mac
lsof -i :8080
kill -9 <进程ID>
问题3:AI API调用失败

错误信息:

Error: Failed to call AI API: timeout

可能原因及解决:

  1. API密钥错误

    • 检查配置中的API密钥是否正确

    • 确认密钥未过期

  2. 余额不足

    • 登录DeepSeek/Qwen后台

    • 检查账户余额

    • 充值

  3. 网络问题

    • 检查服务器网络连接

    • 尝试ping api.deepseek.com

    • 如在国内,可能需要配置代理

  4. API速率限制

    • 降低扫描频率(改为5分钟或10分钟)

    • 联系AI平台提升限额

问题4:币安API连接失败

错误信息:

Error: Invalid API-key, IP, or permissions

解决步骤:

  1. 检查API密钥

    - 确认API Key和Secret Key正确
    - 没有多余的空格
    - 注意大小写
    
  2. 检查API权限

    - 币安后台确认勾选了"合约交易"权限
    - 未勾选"提现"权限(安全起见)
    
  3. 检查IP白名单

    - 如果设置了IP白名单,确认当前IP在列表中
    - 可以临时取消白名单测试
    - 测试通过后再重新添加
    
  4. 检查时间同步

    # Linux检查系统时间
    date# 如果时间不准,同步时间
    sudo ntpdate -u time.nist.gov
    
问题5:Web界面无法访问

错误信息:

无法访问此网站 localhost 拒绝了我们的连接请求

解决方法:

  1. 检查服务是否运行

    docker compose ps
    # 确认nofx-frontend状态为Up
    
  2. 检查端口映射

    docker compose logs nofx-frontend
    # 查看是否有错误信息
    
  3. 尝试其他端口

    http://localhost:3000
    http://127.0.0.1:3000
    http://你的服务器IP:3000
    
问题6:持仓数据不更新

症状:

  • 权益曲线不动

  • 持仓盈亏不变化

解决方法:

  1. 强制刷新页面

    Ctrl + F5(Windows)
    Cmd + Shift + R(Mac)
    
  2. 检查后端连接

    # 测试API是否正常
    curl http://localhost:8080/api/health
    
  3. 重启系统

    docker compose restart
    

8.2 日志查看

Docker部署查看日志:

# 查看所有日志
docker compose logs# 只看后端日志
docker compose logs nofx# 只看前端日志
docker compose logs nofx-frontend# 实时跟踪日志
docker compose logs -f# 查看最近100行
docker compose logs --tail=100

手动部署查看日志:

# 后端日志在终端直接显示
# 前端日志在浏览器Console(F12)# 决策日志位置
cd decision_logs
ls -l  # 查看所有交易员的日志目录

8.3 数据备份与恢复

备份数据:

# 备份配置数据库
cp config.db config.db.backup# 备份决策日志
tar -czf decision_logs_backup.tar.gz decision_logs/# 备份配置文件
cp config.json config.json.backup

恢复数据:

# 停止系统
docker compose down# 恢复数据库
cp config.db.backup config.db# 恢复日志
tar -xzf decision_logs_backup.tar.gz# 重启系统
docker compose up -d

自动备份脚本(Linux):

#!/bin/bash
# backup.shDATE=$(date +%Y%m%d_%H%M%S)
BACKUP_DIR="backups"mkdir -p $BACKUP_DIR# 备份数据库
cp config.db $BACKUP_DIR/config.db.$DATE# 备份日志(最近7天)
find decision_logs -name "*.json" -mtime -7 | tar -czf $BACKUP_DIR/logs.$DATE.tar.gz -T -echo "备份完成: $BACKUP_DIR/config.db.$DATE"

设置定时备份(crontab):

# 编辑crontab
crontab -e# 添加:每天凌晨2点备份
0 2 * * * /path/to/nofx/backup.sh

第九部分:最佳实践

9.1 新手起步建议

第1周:测试阶段

✅ 只投入100-200 USDT测试资金
✅ 使用5倍杠杆(保守)
✅ 只交易BTC和ETH(主流币)
✅ 每天查看2-3次,不要过度关注
✅ 重点学习AI的决策逻辑

第2-4周:观察阶段

✅ 记录每笔交易的盈亏
✅ 分析哪些市场环境下表现更好
✅ 尝试微调自定义策略
✅ 对比不同扫描间隔的效果
✅ 开始关注夏普比率、最大回撤等指标

1-3个月:优化阶段

✅ 根据表现决定是否增加资金
✅ 尝试多交易员策略(AI对比)
✅ 优化个性化策略Prompt
✅ 记录特殊市场事件对策略的影响
✅ 建立自己的交易规则

9.2 资金管理策略

分级投入:

阶段资金量杠杆目的
测试期100-200U3-5x熟悉系统
验证期500-1000U5x验证策略
稳定期1000-5000U5-10x稳定运行
扩展期5000U+根据经验规模化

风险控制:

1. 单账户资金不超过可投资资产的20%
2. 每月最大亏损容忍度:-10%(触发则暂停)
3. 连续3天亏损:降低杠杆或暂停
4. 大盈利后(+30%以上):取出本金,用利润继续

9.3 监控频率建议

过度监控的坏处:

  • 容易情绪化干预AI决策

  • 增加心理压力

  • 影响正常工作生活

推荐监控频率:

情况频率关注点
正常运行每天2次(早晚)账户状态、持仓盈亏
有持仓时每天3-4次是否触发止损止盈
市场剧烈波动每2-4小时是否需要手动干预
测试新策略每天5-6次AI决策逻辑分析

设置警报:

推荐配置:
- 单日亏损>5%:邮件/短信通知
- 账户权益<初始余额80%:警报
- 系统异常停止:立即通知

9.4 不同市场环境应对

牛市(持续上涨):

✅ 优先做多,减少做空
✅ 适当提高仓位(从5x到10x)
✅ 持仓时间可以更长(让利润奔跑)
✅ 关注突破型机会

熊市(持续下跌):

✅ 减少交易频率(改为10分钟扫描)
✅ 降低杠杆(5x以下)
✅ 严格止损,快进快出
✅ 可以尝试做空策略
⚠️ 考虑暂停,等待转势

震荡市(横盘):

✅ 适合高频策略(3分钟扫描)
✅ 缩短止盈目标(2-3%即可)
✅ 避免重仓单向
✅ 关注超买超卖信号(RSI)

暴涨暴跌(剧烈波动):

⚠️ 手动停止交易员
⚠️ 等待市场稳定
⚠️ AI在极端行情下可能判断失误
⚠️ 如有持仓,密切关注强平价

9.5 多交易员组合策略

策略组合示例:

交易员A:保守稳健
- DeepSeek
- 5倍杠杆
- 只做BTC/ETH
- 5分钟扫描
- 资金占比:50%交易员B:平衡激进
- Qwen
- 10倍杠杆
- BTC/ETH/主流币
- 3分钟扫描
- 资金占比:30%交易员C:实验性
- 自定义策略
- 5倍杠杆
- 测试新想法
- 资金占比:20%

优势:

  • 分散风险

  • 对比不同AI模型和策略

  • 学习不同风格的优劣


第十部分:常见问题FAQ

Q1:系统会自动止损吗?

答: 会!每笔开仓都会自动设置止损订单。

  • AI在做决策时会计算止损价和止盈价

  • 系统执行时会同时下"开仓单"和"止损/止盈单"

  • 触发条件后会自动平仓,无需人工干预

Q2:我可以手动干预吗?

答: 可以!你有完全控制权。

手动平仓:

  • Web界面持仓列表点击"平仓"按钮

  • 或直接在币安APP/网页端操作

手动调整止损止盈:

  • Web界面点击"修改止损止盈"

  • 或在币安端修改委托订单

手动开仓:

  • 建议不要,会干扰AI的整体策略

  • 如需手动交易,建议用另一个账户

Q3:可以同时运行多个交易员吗?

答: 完全可以!

前提条件:

  • 每个交易员需要独立的交易所账户

  • 或使用不同交易所(一个币安,一个Hyperliquid)

示例配置:

交易员1: DeepSeek + 币安账户A
交易员2: Qwen + 币安账户B
交易员3: DeepSeek + Hyperliquid账户

这样可以实现AI模型PK,非常有趣!

Q4:夜间会自动交易吗?

答: 会!这正是AI的优势。

  • 24小时自动运行

  • 不会错过任何机会

  • 不受情绪影响

但要注意:

  • 确保服务器/电脑不关机

  • 网络连接稳定

  • 建议部署到云服务器

Q5:亏损了怎么办?

答: 冷静分析,理性应对。

短期亏损(-5%以内):

  • 正常波动,观察几天

  • 查看AI决策日志,分析原因

  • 检查是否遇到不利市场环境

中期亏损(-10%左右):

  • 降低杠杆倍数

  • 减少交易频率

  • 考虑调整策略Prompt

严重亏损(-20%以上):

  • 立即停止交易员

  • 全面复盘所有交易

  • 判断是策略问题还是市场环境问题

  • 必要时暂停一段时间

记住:止损是为了保护本金!

Q6:哪个AI模型更好?

答: 没有绝对答案,各有特点。

DeepSeek:

  • ✅ 便宜($0.14/百万tokens)

  • ✅ 快速(响应<2秒)

  • ✅ 稳定,适合保守策略

  • ❌ 有时过于谨慎

Qwen(通义千问):

  • ✅ 中文理解好

  • ✅ 有时更激进,收益可能更高

  • ❌ 风险也相对更大

  • ❌ 可能需要中国手机号注册

建议:

  • 新手先用DeepSeek

  • 有经验后可以同时运行两个对比

Q7:能保证盈利吗?

答: 不能!必须实话实说。

AI能做的:

  • ✅ 24小时监控,不错过机会

  • ✅ 纪律执行,不情绪化

  • ✅ 多维度分析,决策更全面

  • ✅ 自学习优化,避免重复错误

AI做不到的:

  • ❌ 预测黑天鹅事件

  • ❌ 对抗市场大趋势

  • ❌ 100%胜率

实际表现(用户反馈):

  • 震荡市/牛市:60%用户盈利

  • 熊市:约40%用户盈利

  • 年化收益:-20%到+50%不等

重要: 只投入你能承受损失的资金!

Q8:API密钥安全吗?

答: 遵守安全规则就安全。

安全措施:

  1. ✅ 只开"合约交易"权限,不开"提现"

  2. ✅ 绑定IP白名单

  3. ✅ 定期更换API密钥

  4. ✅ 不要分享给任何人

  5. ✅ config.json不要上传到公开仓库

即使泄露:

  • 黑客最多只能帮你交易(亏损)

  • 无法提现你的资金

  • 发现后立即在币安端删除API

Q9:可以用于股票/期货吗?

答: 目前不行,但未来会支持。

当前支持:

  • ✅ 加密货币合约(币安、Hyperliquid、Aster)

计划支持(Roadmap):

  • 🔜 美股、A股

  • 🔜 商品期货

  • 🔜 外汇市场

  • 🔜 期权交易

架构上支持扩展,只需要对接新的交易所API。

Q10:系统开源吗?

答: 完全开源!

  • GitHub:https://github.com/tinkle-community/nofx

  • 代码可审计、可修改

  • MIT许可证

  • 欢迎贡献代码

好处:

  • 透明,没有后门

  • 社区驱动,持续改进

  • 可以自己定制功能


附录A:快速参考卡

常用命令

# Docker 管理
docker compose up -d --build    # 启动系统
docker compose down             # 停止系统
docker compose restart          # 重启系统
docker compose logs -f          # 查看日志
docker compose ps               # 查看状态# 数据备份
cp config.db config.db.backup   # 备份数据库
cp config.json config.json.bak  # 备份配置# 系统访问
http://localhost:3000           # Web界面
http://localhost:8080/api/health # API健康检查

关键配置

{"admin_mode": true,"use_default_coins": true,"api_server_port": 8080,"jwt_secret": "你的64位随机字符串","leverage": {"btc_eth_leverage": 5,"altcoin_leverage": 5},"max_daily_loss": 10.0,"max_drawdown": 20.0
}

重要端口

服务端口用途
前端3000Web界面
后端API8080API服务

目录结构

nofx/
├── config.json           # 系统配置
├── config.db             # SQLite数据库
├── decision_logs/        # AI决策日志
│   └── {trader_id}/      # 按交易员分类
├── docker-compose.yml    # Docker配置
└── web/                  # 前端代码

附录B:支持资源

官方资源

  • GitHub: https://github.com/tinkle-community/nofx

  • Twitter: @nofx_ai

  • Telegram: NOFX Developer Community

  • 文档: https://github.com/tinkle-community/nofx/tree/main/docs

学习资源

  • 量化交易入门:《量化投资:以Python为工具》

  • 技术分析:《日本蜡烛图技术》

  • 风险管理:《交易心理分析》

  • 加密货币:CoinMarketCap学院

社区支持

  • 问题反馈: GitHub Issues

  • 功能建议: GitHub Discussions

  • Telegram群: 实时交流,快速响应

  • 故障排查: 官方文档


附录C:更新日志

v3.0.0 (2025-10-30) - 重大更新

核心改进:

  • ✅ 完全数据库驱动(SQLite)

  • ✅ Web界面配置(无需编辑JSON)

  • ✅ 用户认证系统(JWT + 2FA)

  • ✅ 多AI模型、多交易所灵活组合

  • ✅ 增强的API层

详细更新:

  • 英文版

  • 中文版


结语

恭喜你读完这份使用手册!🎉

现在你应该已经掌握了:

  • ✅ NOFX的基本原理和工作流程

  • ✅ 如何部署和配置系统

  • ✅ 如何创建和管理交易员

  • ✅ 如何监控和分析交易表现

  • ✅ 常见问题的解决方法

  • ✅ 最佳实践和风险控制策略

记住最重要的三点:

  1. 从小做起 - 用100-200U测试,不要着急投入大资金

  2. 持续学习 - 每周复盘AI决策日志,理解其逻辑

  3. 风险控制 - 设置止损阈值,不要贪婪,保护本金

下一步建议:

1. 注册币安账户和DeepSeek API(如果还没有)
2. 按照第三部分完成系统部署
3. 创建第一个交易员,开始测试
4. 每天花5-10分钟查看监控面板
5. 一周后复盘表现,调整策略
6. 加入Telegram社区,和其他用户交流

需要帮助?

  • 📘 再读一遍相关章节

  • 🔍 查看故障排查指南

  • 💬 加入Telegram群提问

  • 🐛 提交Issue

祝你使用愉快,交易顺利!🚀

更多AIGC文章

RAG技术全解:从原理到实战的简明指南

更多VibeCoding文章

http://www.dtcms.com/a/565488.html

相关文章:

  • 别人把我做的网站_我自己现在想把网站背景改掉_我要怎么改wordpress 翻译不起作用
  • 网站建设要咨询哪些店铺推广是如何收费的
  • 智能建站网业车怎么打车
  • 玩转Rust高级应用 如何进行面向对象设计模式的实现,实现状态模式
  • B2B中药饮片电商平台是什么?其主要特征和价值是什么?
  • 无锡公司网站制作深圳5区发布通知
  • lamp做网站的论文微平台网站开发
  • 【Linux网络编程】初识网络,理解TCP/IP五层模型
  • 如何分析linux相关的系统日志
  • 网页设计作业--接口文档的撰写
  • 第一次找人做网站微信运营专员是什么工作
  • vue2中的.native修饰符和$listeners组件属性
  • 网站建设情况报告范文wordpress首页怎么控制
  • 家政小程序拓展分析:从工具型产品到全链路服务生态的技术落地与商业破局
  • 中国十大门户网站排行定远建设小学投诉网站
  • 外贸网站制作哪家快wordpress删除站点
  • 检查部门网站建设网站建设的主题
  • 网站尾部一般怎么做室内设计公司排名榜
  • Spring Boot 集成 MQTT 实现消息发布与订阅
  • 【Linux系统编程】进程概念(二)进程的概念和基本操作
  • 建收费网站营销型网站建设风格设定包括哪些方面?
  • 【深度强化学习】#6 Soft Actor-Critic:最大熵与重参数化技巧
  • 教务管理系统源码
  • Demis Hassabis带领DeepMind告别纯科研时代:当AI4S成为新叙事,伦理考验仍在继续
  • 顺德网站建设域名网站的规划与建设_按时间顺序可以分为哪等五个阶段
  • 基于Python与Streamlit的救援物资调度双层规划模型实现方案
  • 高阶金融衍生品系统实战:TRS收益互换与场外期权的万亿级交易架构设计
  • 没有备案的网站可以用ip访问吗wifi小程序源码
  • idea远程debug 断点调试
  • Windows 10 停服下的国产化迁移:统信 UOS 工具核心技术深度解析