家用住宅机器搭建AI中转服务完整教程
为什么要在家里搭建AI中转服务
很多人使用ChatGPT、Claude等AI服务时,面临API调用不稳定、多个密钥管理混乱、团队共享困难等问题。
用家里的普通电脑搭建一个AI中转服务,可以把所有API请求统一转发,还能实现负载均衡、用量统计和访问控制。
本文带你从零开始,用Docker在Windows或Linux上快速部署一个轻量级中转平台。
前置准备:你需要的东西
- 一台能正常上网的家用电脑(Windows / macOS / Linux 均可)
- 基本的终端操作能力(打开命令行,会复制粘贴命令)
- Docker 环境(如果还没装,下面会说明安装方法)
- 一个或多个AI平台的API密钥(例如OpenAI的API Key)
如果你只有内网需求(不对外暴露),直接跟着操作即可;
如果需要在外网访问,还需要准备内网穿透工具(如frp、Cloudflare Tunnel)或公网IP。
第一步:安装Docker环境
Docker 可以让你的服务运行在隔离的“容器”里,避免污染系统环境。
Windows / macOS 用户
- 前往 Docker 官网下载 Docker Desktop 并安装。
- 安装完成后启动,根据提示完成初始化(可能需要注册账号,但可以跳过)。
- 打开终端(PowerShell 或 CMD),运行
docker version,如果显示版本号则说明安装成功。
Linux 用户(以Ubuntu为例)
# 更新软件包索引
sudo apt update
# 安装依赖
sudo apt install -y ca-certificates curl gnupg lsb-release
# 添加Docker官方GPG密钥
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
# 添加Docker仓库
sudo add-apt-repository "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
# 安装Docker
sudo apt install -y docker-ce docker-ce-cli containerd.io
# 启动Docker并设置开机自启
sudo systemctl start docker
sudo systemctl enable docker
验证:sudo docker run hello-world 看到欢迎信息即可。
第二步:部署AI中转服务(以New-API为例)
New-API 是一个开源项目,支持多种AI模型API的统一中转,界面简单易用。
- 在终端执行以下命令拉取镜像并启动容器:
sudo docker run --name new-api -d --restart always -p 3000:3000 \
-v ./data:/data \
-e SESSION_SECRET=$(openssl rand -base64 32) \
calciumion/new-api:latest
命令解释:
--name new-api给容器取名。-d后台运行。--restart always容器停止后自动重启。-p 3000:3000将宿主机3000端口映射到容器内的3000端口。-v ./data:/data持久化数据到当前目录下的data文件夹。-e SESSION_SECRET设置一个随机密钥用于会话安全。
- 等待几秒,打开浏览器访问
http://你的电脑IP:3000,默认账号密码为root / 123456。
第三步:配置中转服务并添加AI渠道
登录后你会看到管理后台。
按以下步骤设置:
- 修改默认密码:点击右上角头像 → 个人设置 → 修改密码。
- 添加渠道:左侧菜单“渠道” → 添加渠道。
- 类型选择“OpenAI”。
- 填写你的真实API Key(从OpenAI官网获取)。
- 代理地址留空或填写你的网络代理地址(如果本地需要代理才能访问OpenAI)。
- 保存。
- 创建令牌:左侧菜单“令牌” → 添加令牌。
- 给令牌起个名字,选择允许的模型范围(建议全选)。
- 设置额度限制(可选),保存得到一串以
sk-开头的令牌。
现在,你的中转服务已经可以用了。
只需要把客户端(如ChatGPT Next、OpenCat等)的API地址改成 http://你的电脑IP:3000,API Key换成刚才生成的令牌,即可通过家里电脑转发请求。
避坑指南:家庭网络环境的常见问题
- 端口被占用:如果3000端口已经被其他程序占用,修改启动命令中的
-p 3000:3000为-p 3001:3000,访问时用http://IP:3001。 - 防火墙拦截:Windows需在“防火墙高级设置”中添加入站规则,开放3000端口;Linux使用
sudo ufw allow 3000开放端口。 - 内网穿透才可外网访问:家里通常没有固定公网IP,需要搭配 frp 或 Cloudflare Tunnel 才能从外网访问。具体教程可以搜索“frp 内网穿透”或“Cloudflare Tunnel 配置”。
- 容器数据丢失:启动时务必添加
-v ./data:/data参数,否则升级容器后所有配置都会丢失。
效果验证:检查中转是否正常工作
- 查看日志:
sudo docker logs new-api可以看到请求记录,确认是否有报错。 - 测试接口:用 curl 或 Postman 发送一个简单请求:
curl http://localhost:3000/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer 你的令牌" \
-d '{
"model": "gpt-3.5-turbo",
"messages": [{"role": "user", "content": "Hello"}]
}'
如果返回正常的AI回复JSON,证明中转成功。
- 在客户端使用:比如在ChatGPT Next Web中,设置接口地址为
http://192.168.1.100:3000(换成你电脑的实际IP),API Key填写刚才生成的令牌,即可聊天。
常见问题解答
Q:我的电脑是Windows,Docker Desktop启动很慢怎么办?
A:可以尝试使用 WSL2 后端,或者干脆改用Linux虚拟机。家庭用户直接用 Windows 版也是可以的,初次启动资源占用会稍高。
Q:中转服务稳定吗?会不会把家庭宽带搞崩?
A:如果只供个人或少数人使用,并发不高,完全没问题。大量并发请求可能触发运营商限制,建议控制令牌的速率限制。
Q:能否自动负载均衡多个API Key?
A:New-API支持添加多个渠道,它会自动轮询。如果某个Key配额用完,会自动切换到下一个。
写在最后
在家用机器上搭建AI中转服务,既能保护API Key安全,又能统一管理多平台账号。
本文以New-API为例,Docker部署方式对系统无污染,升级也非常方便(删除旧容器、拉新镜像再运行即可)。
如果你需要对外提供中转,记得配合内网穿透工具;
如果只是自用,内网访问完全够用。
按照以上步骤操作,二十分钟内就能看到效果。
遇到卡壳时,回头看看“避坑指南”部分,大部分问题都能解决。
如果你对Docker基础命令还不熟悉,可以继续学习《Docker入门到实战》相关教程;
如果需要更高级的限流、缓存功能,也可以尝试其他开源项目如One API。