家用住宅机器搭建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 用户

  1. 前往 Docker 官网下载 Docker Desktop 并安装。
  2. 安装完成后启动,根据提示完成初始化(可能需要注册账号,但可以跳过)。
  3. 打开终端(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的统一中转,界面简单易用。

  1. 在终端执行以下命令拉取镜像并启动容器:
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 设置一个随机密钥用于会话安全。
  1. 等待几秒,打开浏览器访问 http://你的电脑IP:3000,默认账号密码为 root / 123456

第三步:配置中转服务并添加AI渠道

登录后你会看到管理后台。
按以下步骤设置:

  1. 修改默认密码:点击右上角头像 → 个人设置 → 修改密码。
  2. 添加渠道:左侧菜单“渠道” → 添加渠道。
  • 类型选择“OpenAI”。
  • 填写你的真实API Key(从OpenAI官网获取)。
  • 代理地址留空或填写你的网络代理地址(如果本地需要代理才能访问OpenAI)。
  • 保存。
  1. 创建令牌:左侧菜单“令牌” → 添加令牌。
  • 给令牌起个名字,选择允许的模型范围(建议全选)。
  • 设置额度限制(可选),保存得到一串以 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 参数,否则升级容器后所有配置都会丢失。

效果验证:检查中转是否正常工作

  1. 查看日志sudo docker logs new-api 可以看到请求记录,确认是否有报错。
  2. 测试接口:用 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,证明中转成功。

  1. 在客户端使用:比如在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。

分享到:
上一篇
AI中转站多模型聚合部署:从零搭建统一API网关
下一篇
住宅服务器低功耗AI推理搭建:家用低功耗服务器搭建AI推理环
1
系统公告

高考专属福利来袭|凭准考证免费领香港 CN2 云服务器

值高考落幕之际,泽御云开启考生专属回馈 + 产品限时特惠双重活动,助力学子暑期学习建站 高考 考生专属福利 全体应届高考生,凭高考准考证即可免费申领【香港 CN2 轻量云服务器,4 核 4G AMD 处理器】,免费使用周期 30 天,可用于搭建个人站点、编程实操、技术实训,祝各位考生金榜题名,前程似锦! 泽御云资质齐全合规自营机房,线路覆盖香港 CN2、国内 BGP、内蒙电信、美国精品线路,售后全天候技术支持。 官方网站:www.zeyuyun.com,活动限时有效,优惠逾期不再保留。
服务中心
客服
在线客服
24小时为您服务
咨询
联系我们
联系我们,为您的业务提供专属服务。
24/7 技术支持
如果您遇到寻求进一步的帮助,请过工单与我们进行联系。
24/7 即时支持
泽御云
售前客服
泽御云
泽御云
售后客服
泽御云
技术支持
评价
您对当前页面的整体感受是否满意?
😞
非常不满意
😕
不满意
😐
一般
🙂
满意
😊
非常满意