1. 安装 Go 1.26.0#

Alpine 自带的 Go 1.23 版本太低，需要手动安装 Go 1.26：

1
# 用 Python 下载并解压（比 curl 在 proot 中更稳定）
2
python3 -c "
3
import urllib.request, tarfile
4
url = 'https://dl.google.com/go/go1.26.0.linux-arm64.tar.gz'
5
out = '/tmp/go1.26.0.linux-arm64.tar.gz'
6
print('下载 Go 1.26.0...')
7
req = urllib.request.Request(url, headers={'User-Agent': 'curl/7.0'})
8
data = urllib.request.urlopen(req, timeout=600)
9
with open(out, 'wb') as f:
10
    total = 0
11
    while True:
12
        chunk = data.read(1048576)
13
        if not chunk: break
14
        f.write(chunk)
15
        total += len(chunk)
16
print(f'下载完成: {total/1048576:.1f} MB')
17
print('解压...')
18
with tarfile.open(out, 'r:gz') as tar:
19
    tar.extractall('/usr/local')
20
print('完成')
21
"
22

23
# 验证
24
/usr/local/go/bin/go version
25
# → go version go1.26.0 linux/arm64

注意： dl.google.com 在 proot 环境中 TLS 连接比 go.dev 更稳定。如果下载失败，多试几次或换网络。

2. 获取源码#

1
cd /workspace
2

3
# 方式 A：Git 克隆（可能遇到 TLS 错误）
4
git clone https://github.com/CJackHwang/ds2api.git
5

6
# 方式 B：下载 Release 源码包（更可靠）
7
curl -L -o ds2api-v4.6.1.tar.gz "https://github.com/CJackHwang/ds2api/archive/refs/tags/v4.6.1.tar.gz"
8
tar xzf ds2api-v4.6.1.tar.gz
9
mv ds2api-4.6.1 ds2api
10
rm ds2api-v4.6.1.tar.gz

3. 编译#

1
export PATH="/usr/local/go/bin:$PATH"
2
cd /workspace/ds2api
3

4
# 使用 goproxy.cn 国内镜像加速依赖下载
5
GONOSUMCHECK=* GONOSUMDB=* GOPROXY=https://goproxy.cn,direct \
6
  go build -o ds2api ./cmd/ds2api

编译成功后生成 /workspace/ds2api/ds2api（约 25MB，ARM64 ELF）。

4. 配置#

复制示例配置并编辑：

1
cp config.example.json config.json

编辑 config.json，关键字段：

1
{
2
  "keys": ["你的API密钥"],           // 客户端调用时用的 API Key
3
  "api_keys": [
4
    {
5
      "key": "你的API密钥",
6
      "name": "主 API Key",
7
      "remark": "本地使用"
8
    }
9
  ],
10
  "accounts": [
11
    {
12
      "name": "主账号",
13
      "email": "你的DeepSeek邮箱",
14
      "password": "你的DeepSeek密码"
15
      // 或用手机号登录：
16
      // "phone": "你的手机号",
17
      // "phone_code": "国际区号如+86"
18
    }
19
  ],
20
  "model_aliases": {
21
    "gpt-4o": "deepseek-v4-flash",
22
    "gpt-5.5": "deepseek-v4-flash",
23
    "o3": "deepseek-v4-pro"
24
  }
25
  // ... 其他配置保持默认即可
26
}

5. 启动#

1
cd /workspace/ds2api
2
./ds2api

启动后监听 http://0.0.0.0:8080（端口见启动日志）。

首次启动注意： 如果提示 [webui] static files missing, running npm build，说明 WebUI 前端静态文件未构建，会自动尝试用 npm 构建。如不需要 WebUI，可忽略此提示。

后台运行（保活）：

1
nohup ./ds2api > /workspace/ds2api/ds2api.log 2>&1 &

或使用 Omnibot 的终端持久会话运行。

基本信息#

支持的端点#

请求示例#

OpenAI 格式（流式）：

1
curl http://127.0.0.1:8080/v1/chat/completions \
2
  -H "Authorization: Bearer 你的API密钥" \
3
  -H "Content-Type: application/json" \
4
  -d '{
5
    "model": "deepseek-v4-flash",
6
    "messages": [{"role": "user", "content": "你好"}],
7
    "stream": true
8
  }'

非流式：

1
curl http://127.0.0.1:8080/v1/chat/completions \
2
  -H "Authorization: Bearer 你的API密钥" \
3
  -H "Content-Type: application/json" \
4
  -d '{
5
    "model": "deepseek-v4-flash",
6
    "messages": [{"role": "user", "content": "你好"}]
7
  }'

客户端配置#

在 ChatGPT 兼容客户端（如 ChatBox、NextChat 等）中：

• API 类型： OpenAI Compatible
• API Base URL： http://127.0.0.1:8080
• API Key： config.json 中设置的 key
• Model： deepseek-v4-flash 或 deepseek-v4-pro

Q: 启动报错 TLS 连接失败？#

A: DeepSeek 需要通过网络访问其 Web 服务。确保手机网络正常。

Q: 编译时 go: go.mod requires go >= 1.26.0？#

A: Alpine 自带的 Go 版本太低（1.23）。需要手动安装 Go 1.26（见步骤 1）。

Q: GOTOOLCHAIN=auto 下载 Go 时 Segmentation fault？#

A: proot 环境下 Go 自动工具链下载不稳定。改用手动下载 tar.gz 包安装。

Q: Git clone 报 TLS 错误？#

A: 改用下载 Release 源码包的方式获取代码（方式 B）。

Q: 与 qoder-cn-proxy 有什么区别？#

A: qoder-cn-proxy 调用 Qoder CN 官方 API，需要 PAT Token。ds2api 模拟 DeepSeek 网页端对话，需要 DeepSeek 账号密码。两者是不同的 API 代理方案。

Q: 手机浏览器访问 127.0.0.1:8080 超时？#

A: 在手机浏览器中用 http://127.0.0.1:8080（不要用局域网 IP）。