1. 为什么要在 Docker 里跑 OneAPI 再接 DeepSeek如果你手上有三五个模型供应商的 Key每次换项目就要翻一遍配置文件改环境变量、改 base_url、改模型名改到最后自己都记不清哪个 Key 对应哪个服务。OneAPI 解决的就是这个问题它把不同厂商的接口统一成 OpenAI 兼容格式你只需要在 OneAPI 后台配一次渠道之后所有客户端都只认一个地址、一个 Key。但实际用起来还有一层麻烦OneAPI 本身要部署、要维护、要占一台机器或者一个端口。如果你只是想在本地或者测试环境快速验证 DeepSeek 的调用链路从零装 Docker、拉镜像、配渠道、建 Token这一套走下来少说半小时。更别说有些场景下你根本不想在本地跑一个常驻服务只想让代码里那个base_url指向一个稳定可用的统一入口。这篇要做的是把两条路都讲清楚一条是完整的 Docker 部署 OneAPI 并接入 DeepSeek适合你想自己掌控渠道和计费的场景另一条是用 TaoToken 作为统一 Key 通道跳过本地部署直接拿到一个兼容 OpenAI 的入口把 DeepSeek 接进你的项目。两条路最后都会落到同一个验证命令上你可以按自己的需求选。适合谁看正在用 Docker 做本地 AI 服务编排的开发者、需要给团队统一模型入口的后端同学、以及想用一份配置同时跑通多个模型客户端的折腾党。下面从 Docker 部署开始每一步都给可复制的命令和配置。2. TaoToken 前置统一 Key 与 API 通道准备在讲 Docker 之前先把 TaoToken 这条线说清楚因为后面验证环节会用到它作为对照。TaoToken 提供的是一个 OpenAI 兼容的统一 API 入口你不需要在本地跑 OneAPI也能拿到一个稳定的base_url和 Key直接对接 DeepSeek 等模型。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 注意 API 地址后面不加 UTM 参数直接写就行。你需要做的准备只有两步注册后进控制台创建 API Key然后把这个 Key 写进你的客户端配置。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API Keys 管理页是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。拿到 Key 之后你的base_url就固定为https://taotoken.net/api模型名按 DeepSeek 的命名填。这样你的代码里不需要区分是 OneAPI 还是 TaoToken只要改base_url和api_key两个值就能在本地 OneAPI 和 TaoToken 之间切换。提示TaoToken 的 Key 和 OneAPI 自己生成的 Token 是两套东西。OneAPI 的 Token 是sk-开头的一串TaoToken 的 Key 也是sk-开头但两者不能混用。验证的时候注意区分你当前用的是哪个入口。如果你只是想快速验证 DeepSeek 能不能通不想折腾 Docker可以直接跳到第 4 节的验证命令把base_url换成 TaoToken 的地址即可。下面第 3 节是完整的 Docker 部署流程适合需要自建渠道管理的场景。3. 可复制配置docker-compose.yml 与 OneAPI 渠道3.1 用 docker-compose 启动 OneAPI原始教程里用的是docker run一行命令能跑但参数多了之后不好维护。我习惯用docker-compose.yml把端口、卷、时区、重启策略都写进文件改起来清楚迁移也方便。新建一个目录比如/opt/one-api在里面创建docker-compose.ymlversion: 3.8 services: one-api: image: justsong/one-api:latest container_name: one-api restart: always ports: - 3000:3000 environment: - TZAsia/Shanghai volumes: - ./data:/data healthcheck: test: [CMD, wget, -q, -O, -, http://localhost:3000/api/status] interval: 30s timeout: 5s retries: 3几个参数说明一下。ports左边是宿主机端口右边是容器内端口OneAPI 默认监听 3000如果你宿主机 3000 被占了把左边改成 3001 或者别的。volumes把当前目录下的data挂到容器/data这样渠道配置、Token、日志都持久化在本地容器删了重建数据还在。healthcheck是我加的用来确认服务真的起来了不是容器在跑但进程挂了。启动命令cd /opt/one-api docker compose up -d如果你用的是老版本 Docker命令可能是docker-compose up -d带横杠。启动后看状态docker compose ps预期输出里STATUS应该是Up或者Up (healthy)。如果显示Restarting多半是端口冲突或者卷权限问题先看日志docker compose logs -f one-api3.2 初始化后台并创建 DeepSeek 渠道浏览器打开http://你的服务器IP:3000默认账号root默认密码123456。第一次登录会强制你改密码改完重新登录。进去之后先做一件事改默认密码。然后进Channels页面点Add Channel。类型选DeepSeek名称随便填比如deepseek-main。分组保持default。模型列表填 DeepSeek 支持的模型名比如deepseek-chat、deepseek-reasoner具体以你拿到的模型清单为准。Key 填你在 DeepSeek 开放平台创建的 API Key。保存之后渠道列表里会显示这个渠道点右边的Test按钮测一下。如果返回API Error: 402 Insufficient Balance说明 DeepSeek 账户余额不足去充值。如果返回成功说明渠道通了。3.3 创建 OneAPI Token 并写入 settings.json渠道通了之后进Tokens页面点Add Token名称自定义其他默认。创建完成后复制那串sk-开头的 Raw Token这就是你调用 OneAPI 时用的 Key。如果你用的是某些支持settings.json的客户端或者工具可以把配置写成这样{ api_base: http://localhost:3000/v1, api_key: sk-你的OneAPI-Token, model: deepseek-chat, provider: openai-compatible }如果你走的是 TaoToken 通道同样的结构只改两个值{ api_base: https://taotoken.net/api, api_key: sk-你的TaoToken-Key, model: deepseek-chat, provider: openai-compatible }注意api_base的写法OneAPI 是http://localhost:3000/v1TaoToken 是https://taotoken.net/api后面都不需要再加/v1因为 TaoToken 的入口已经包含了版本路径。这一点容易搞混写错了会返回 404。4. 验证请求curl 命令与预期返回配置写好了得验证。最直接的方式是 curl。先验证 OneAPI 本地入口curl http://localhost:3000/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的OneAPI-Token \ -d { model: deepseek-chat, messages: [ {role: user, content: 请回复OneAPI 接入 DeepSeek 成功} ], stream: false }预期返回是一个 JSONchoices[0].message.content里应该有模型回复的内容。如果返回401检查 Token 是不是复制完整了有没有多余空格。如果返回404检查base_url是不是写成了http://localhost:3000而漏了/v1。再验证 TaoToken 入口curl https://taotoken.net/api/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的TaoToken-Key \ -d { model: deepseek-chat, messages: [ {role: user, content: 请回复TaoToken 通道验证成功} ], stream: false }两个命令的返回结构应该是一样的因为都是 OpenAI 兼容格式。区别只在于base_url和 Key。如果你两个都通了说明你的客户端配置可以在这两个入口之间自由切换。注意TaoToken 的 API 地址是https://taotoken.net/api调用 chat completions 时路径是/chat/completions拼起来就是https://taotoken.net/api/chat/completions。不要写成https://taotoken.net/api/v1/chat/completions多一层/v1会 404。如果你在 Python 里用openai库配置是这样的from openai import OpenAI client OpenAI( base_urlhttps://taotoken.net/api, api_keysk-你的TaoToken-Key ) resp client.chat.completions.create( modeldeepseek-chat, messages[{role: user, content: 用一句话说明当前通道可用}] ) print(resp.choices[0].message.content)跑通之后你会看到模型返回的一句话说明整条链路从客户端到模型服务是通的。5. 本篇常见错排查5.1 容器起来了但浏览器打不开 3000 端口先确认容器状态docker compose ps看STATUS是不是Up。如果是Up但访问不了检查宿主机防火墙有没有放行 3000云服务器还要看安全组规则。本地的话用lsof -i :3000看端口是不是被别的进程占了占了就改docker-compose.yml里的端口映射比如改成3001:3000然后docker compose up -d重建。5.2 渠道测试报 402 Insufficient Balance这是 DeepSeek 账户余额不足不是 OneAPI 的问题。去 DeepSeek 开放平台充值或者换一个有余额的 Key。如果你用的是 TaoToken 通道不会出现这个报错因为计费走的是 TaoToken 那边你只需要确认 TaoToken 账户状态正常。5.3 调用返回 401 Unauthorized三种可能Key 复制错了、Key 前后有空格、或者你用了 OneAPI 的 Token 去调 TaoToken 的地址。检查Authorization头里的 Key 是不是当前入口对应的那一个。OneAPI 的 Token 在Tokens页面复制TaoToken 的 Key 在 API Keys 页面复制两者不通用。5.4 返回 404 Not Found最常见的原因是base_url路径写错。OneAPI 本地是http://localhost:3000/v1TaoToken 是https://taotoken.net/api。如果你在 TaoToken 的地址后面又加了/v1就会 404。另外检查一下chat/completions有没有拼错少个 s 也会 404。5.5 模型名不对导致 400 错误DeepSeek 的模型名要和你渠道里配置的一致。如果你在 OneAPI 渠道里填的是deepseek-chat调用时model字段也要写deepseek-chat。写错了会返回400 Bad Request提示模型不存在。TaoToken 通道同理模型名按平台文档给的写。5.6 Docker 卷权限问题导致数据写不进去如果你把./data挂载到容器里但宿主机目录权限不对OneAPI 可能启动失败或者配置保存不了。检查data目录的属主必要时改成可写sudo chown -R 1000:1000 /opt/one-api/data或者简单点先不挂载卷用容器内默认路径跑起来验证通了再补挂载。6. 接入方式怎么选本地 OneAPI 还是 TaoToken 通道两条路我都跑过。本地 Docker 部署 OneAPI 的好处是渠道完全自己控计费、日志、限流都在自己手里适合团队内部用或者你需要把多个厂商的 Key 统一管理起来。缺点是你要维护这台服务服务器重启、端口冲突、卷权限这些事都得自己处理。TaoToken 通道的好处是省掉了部署和维护base_url和 Key 拿到就能用适合快速验证、个人项目、或者你不想在本地跑常驻服务的场景。如果你后面要长期做编码或者 Agent 类的项目可以看下 Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有适合长期调用的方案。如果你只是想先试试模型对话效果可以直接进模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 不用写代码就能验证 DeepSeek 的返回。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有各语言的调用示例。ClaudeCode 相关的接入说明在 https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 如果你用 ClaudeCode 做开发可以对照配置。我自己的做法是本地留一个 OneAPI 做渠道管理和日志留存日常写代码和跑 Agent 的时候把base_url切到 TaoToken省得本地服务挂了影响干活。两套配置都在settings.json里改一行就能切。
