unCoded
新手友好指南

搭建 unCoded 交易机器人 在你自己的服务器上

在你自己的服务器上运行机器人并连接到你的交易所，无需写一行代码。

你自己的服务器

位于德国

安全的交易所 API

子账户 + IP 白名单

自动交易

仪表盘 + 可选 Telegram

快速术语表

第 1 部分

开始之前 - 必做准备

没有这三点，搭建无法完成。如果你已经在主动使用交易所，可以跳过。

准备 A - 完成交易所 KYC

成果： 一个完全验证的交易所账户（API 和子账户的前提）。

交易 API 和子账户仅向完全验证的交易所用户开放。

准备 B - 开启 2FA

成果： 你的交易所账户上已启用双重身份验证。

在创建任何 API 密钥之前，你的交易所都要求开启 2FA。

如果你丢了手机又没有备份密钥，就会失去账户访问权限。YubiKey 硬件密钥能提供更强的保护。

准备 C - 充值 USDC 或 FDUSD

成果： 计价货币已就绪，可转入你的子账户。

机器人用一种计价货币进行交易，启动前这种货币必须在子账户里。

第 2 部分

分步搭建

从买服务器到机器人完全运行，共十四步。

1

在 Zeabur 上买一台服务器

成果： 一台位于德国、拥有自己 IPv4 地址的运行中服务器。

  • ›打开 Zeabur 仪表盘并用 Google 登录。
  • ›点击 'Buy More Servers'。
  • ›选择德国的 Hetzner（每月约 16 美元）。
  • ›配置：4 个 vCPU，位置德国，专用 IP。

安全网：7 天内你可以退款服务器。如果你只想测试一个月，也可以关闭自动续费。开机时间约 3 到 4 分钟。

结果： 服务器正在运行，IPv4 地址已记下。

2

打开 unCoded 模板

成果： Zeabur 表单已打开，准备填写。

  • ›在 Zeabur 进入 'Projects' -> 'Generate Project'。
  • ›在 'Deploy New Service' 下搜索 'uncoded'。
  • ›选择你刚买的那台服务器。

先不要填任何内容，需要的数值我们会在接下来的步骤里逐一收集。

3

创建一个交易所子账户

成果： 一个与你主账户干净隔离的第二个交易所账户。

  • ›在你的交易所点击头像（右上角）。
  • ›在菜单里点击 'Sub Accounts'（或等价项）。
  • ›'Create Sub Account' -> 'Create with Mail'。
  • ›输入第二个邮箱地址和一个密码。
  • ›开启 'Switchable'，这样你就能一键在主账户和子账户之间切换。

4

在你的交易所创建 API 密钥

成果： API Key 和 Secret Key 已填入 Zeabur 模板。

绝不要为 API 开启提币权限。交易机器人只需要读取 + 交易权限。IP 白名单和交易权限会有意在第 9 步才设置。

  • ›切换到子账户（左上角切换器）。
  • ›个人资料 -> 'API Management'。
  • ›'Create API' -> 'System Generated'。
  • ›给它起个名字，比如 'uncoded Bot' -> Next。
  • ›用 2FA / YubiKey 确认。
  • ›把 API Key 和 Secret Key 复制到 Zeabur 字段 'Exchange API Key' / 'Exchange Secret Key'。

立刻复制 Secret Key，页面关闭后它就再也不会显示了。不要分享给任何人。

结果： API Key 和 Secret Key 已填入 Zeabur 模板。

5

设置仪表盘密码

成果： 为你未来的仪表盘设置两个访问密码。

Zeabur 模板有两个密码字段：

使用带特殊字符的强密码。不要用 'Test1' 之类的。

  • ›Dashboard Admin Password，完全访问权限，包括所有设置。
  • ›Dashboard View Password，只读，例如给你想展示机器人的人。

6

（可选）创建一个 Telegram 机器人

成果： 一个用于 Telegram 通知的机器人 token。

如果你不想要 Telegram 通知，就在两个 Telegram 字段里都填 00 并跳到第 8 步。开启 Telegram 后，每笔交易你都会收到一条带盈利、总盈利和成交量的消息。

  • ›在 Telegram 搜索 @BotFather。
  • ›'Start' -> 发送命令 /newbot。
  • ›起一个显示名称（如 'Uncoded Trading Bot'）。
  • ›起一个内部用户名（必须以 'bot' 结尾，且全局唯一）。
  • ›BotFather 会返回一个 token，形如 123456789:ABCdefGhi...，把它粘进 Zeabur 字段 'Telegram Bot Token'。

7

（可选）获取 Telegram 群组 ID

成果： 包含负号的群组 ID，已填入 Zeabur 模板。

负号 '-' 必须连同数字一起复制。否则连接会失败。

  • ›在 Telegram 创建一个新群组（如 'Uncoded Trading'）。
  • ›把你刚创建的 uncoded 机器人加入群组。
  • ›再把辅助机器人 @myidbot 加入群组。
  • ›把两个机器人都设为管理员（右键 / 长按机器人 -> 'Promote to Admin' -> Save）。
  • ›在群里向 @myidbot 发送 /getgroupid。
  • ›你会得到一个带负号的群组 ID，例如 -1001234567890。

8

设置域名并启动部署

成果： 两个自己的仪表盘 URL 和一次运行中的部署。

模板里需要两个域名：

  • ›仪表盘域名（如 uncoded-yourname-1），用于配置的 Web 仪表盘。
  • ›信号域名（如 uncoded-yourname-2），接收 TradingView 信号的端点。
  • ›规则：仅限小写，两个名字必须不同。
  • ›可选：如果你之后要用 TradingView 信号，现在就设置一个 TradingView 密码（随时可改）。
  • ›在下方选好正确的服务器并点击 'Confirm'。

9

在你的交易所把服务器 IP 加入白名单（关键！）

成果： 一个可交易、且只能从你服务器使用的 API 密钥。

在设置 IP 白名单之前，你的交易所甚至无法勾选 'Enable Spot & Margin Trading'。这是安全机制，不是错误。

  • ›在 Zeabur -> 'Servers' -> 点击你的服务器 -> 复制 IPv4 地址。
  • ›回到你的交易所 -> 'API Management' -> 在你的 uncoded API 密钥上点击 'Edit restrictions'。
  • ›开启 'Restrict access to trusted IPs only'。
  • ›输入服务器 IP -> Confirm。
  • ›现在你可以勾选 'Enable Spot & Margin Trading' -> 启用它。
  • ›用 2FA 确认并 'Save'。不要开启 API 提币，只开交易。

为什么这样很安全：即使有人拿到你的 API Key 和 Secret，他们也什么都做不了，只有这一台服务器 IP 被允许交易。

10

登录仪表盘

成果： 通过你自己的域名访问 unCoded 仪表盘。

一旦仪表盘域名在 Zeabur 里变绿（'Online' / 'Running'），就在浏览器里打开它，用第 5 步的管理员密码登录。

11

选择交易模式和策略

成果： 一个完整配置好模式、计价货币、交易对和风险档位的机器人。

在仪表盘里按顺序选择以下内容：

  • ›机器人类型：Multi-Token Bot（多数用户的标准选择）。High-Frequency Bot 是单币做市，通常不是你想要的。
  • ›计价货币：欧盟内用 USDC；欧盟以外可用 FDUSD（手续费更低 / 为零）。
  • ›交易对：BTC 和 ETH 是不错的起步，流动性高，滑点更低。
  • ›风险档位：Low = 保守（推荐新手）。Medium / High = 更激进（更多分批、更大仓位、更少储备）。
  • ›-> Confirm -> Start。

12

关联你的 Google 账户

成果： 你的许可证已绑定到你的 Google 身份。

  • ›在仪表盘点击 'Open'。
  • ›用你的 Google 账户登录。
  • ›接受服务条款。
  • ›点击 'Start'。

定价：机器人收取已实现利润的 20% 到 30%。没有盈利 = 没有费用。新用户目前可获得 25 美元的许可证额度。

13

激活你的许可证

成果： 机器人唯一绑定到你的账户。

只填公开的 API Key，绝不要填 Secret Key。

  • ›在仪表盘点击 'Top-up License'，你会被跳转到你的 unCoded 账户。
  • ›滚动到 'Your IDs'。
  • ›在这里输入公开的 Exchange API Key。
14

验证一切正常

成果： 确信机器人运行干净。

  • ›在你的 Zeabur 项目里打开交易机器人服务 -> 点击 'Logs'。
  • ›不应出现红色错误。
  • ›交易运行得很快（每笔约 40 到 50 毫秒）。需要时可暂停日志视图。

结果： 机器人在你自己的服务器上独立运行。

第 3 部分

成功是什么样子

下面教你如何在头 1 到 24 小时内判断一切是否正常运行。

立即（5 分钟内）

  • 仪表盘显示 'Bot Status: Running'（绿色）。
  • 日志显示规律的条目，如 'Checking conditions for BTCUSDC...'，没有红色错误。

第一个小时内

  • 当市场条件满足时：日志里出现首批买单。
  • 如果开启了 Telegram：第一条通知（如 'BUY BTCUSDC at 65,420, Split 1/2'）。

24 小时内

  • 首批完成的交易（买入 + 卖出）并显示盈利。
  • 仪表盘统计数据开始填充。

如果 24 小时后还没有发生交易：这不一定是错误。在低波动或保守设置下，可能需要 1 到 3 天才能满足首次入场条件。

第 4 部分

故障排查

第 5 部分

安全清单

绝不分享或发布你的 Secret Key
已在交易所 API 上设置 IP 白名单
已关闭 API 提币
已设置强仪表盘密码
使用子账户，而非主账户
你的交易所上已开启 2FA
2FA 备份密钥已安全保存
所有密码都存在密码管理器里
第 6 部分

调整策略与合理预期

之后再自定义

  • • 切换 模式（如牛市用 Basic 模式）。
  • • 调整 分批（如 50/50）。
  • • 为牛市 / 熊市切换策略。
  • • 在 "回测" 下浏览公开策略和排行榜。

合理预期

  • • 参考：示例周期内约 17,000 笔交易 / 月，约 1,200 美元利润。
  • • 每日结果通常为 12 到 27 美元，偶有向上的离群值。
  • • 粗略参照：年化 30% 到 40% 回报 作为一个现实的大致区间。
  • • 利润是阶梯式增长的（仓位必须平仓），不是线性的。

震荡市和熊市 是机器人能明显跑赢持币的地方。在 极端牛市 中持币偶尔会更占优，所以止损和应急指标才重要。

第 7 部分

风险与免责声明

  • 使用：风险自负。
  • 回报：不保证未来盈利。过往结果不构成预测。
  • 税务：这不是税务建议。交易利润是否纳税取决于你所在国家。
  • 亏损：加密货币交易可能导致亏损，直至本金全部损失。
  • 责任：你对自己的配置、API 密钥和服务器负责。

快速参考

用于重复搭建。

  1. 1在 Zeabur 上买 Hetzner 服务器（4 vCPU，德国）
  2. 2打开 unCoded 模板
  3. 3创建交易所子账户 + 转入 USDC / FDUSD
  4. 4创建 API Key + Secret Key（无提币权限）
  5. 5设置仪表盘密码
  6. 6（可选）通过 BotFather 创建 Telegram 机器人
  7. 7（可选）通过 @myidbot 获取 Telegram 群组 ID（别忘了负号！）
  8. 8设置仪表盘 + 信号域名，启动部署
  9. 9在你的交易所把服务器 IP 加入白名单 + 启用交易
  10. 10登录仪表盘
  11. 11选择 Multi-Token、计价货币、交易对和风险
  12. 12关联 Google 账户
  13. 13激活许可证（公开 API Key）
  14. 14检查日志

需要完整文档？

完整文档可在 /docs 查看。

打开文档
    搭建指南 - 分步教程 | unCoded