小白教程：在Windows的WSL（Ubuntu）中手动部署one-api
前提条件
- 已启用 WSL 并安装 Ubuntu（打开 Windows 终端，输入
wsl可进入 Ubuntu 系统） - Ubuntu 中已联网（可在 Ubuntu 中输入
ping www.baidu.com测试网络）
步骤 1：下载 one-api 软件包
-
打开 Ubuntu 终端（在 Windows 中打开终端，输入
wsl回车） -
进入一个你想存放软件的文件夹（比如用户主目录，无需创建，直接使用）： bash
运行
cd ~ # 这行命令会进入你的个人主文件夹 -
下载 one-api 的 Linux 版本（复制下面的命令粘贴到终端，回车）： bash
运行
wget https://github.com/songquanpeng/one-api/releases/latest/download/one-api-linux-amd64.tar.gz- 说明：
wget是下载文件的工具，后面的链接是 one-api 官方最新版本的下载地址 - 如果下载失败，可能是网络问题，多试几次
- 说明：
步骤 2：解压软件包
-
输入以下命令解压下载的压缩包： bash
运行
tar -zxvf one-api-linux-amd64.tar.gz- 说明：
tar是解压工具，这个命令会把压缩包里的文件释放出来
- 说明：
-
解压后，输入
ls命令，能看到一个名为one-api的文件（这是可执行程序）
步骤 3：创建日志文件夹（可选但推荐）
-
输入以下命令创建一个存放日志的文件夹： bash
运行
mkdir logs- 说明：
mkdir是创建文件夹的命令，logs是文件夹名字，用于存放程序运行记录
- 说明：
步骤 4：启动 one-api 服务
-
输入以下命令启动程序（后台运行，关闭终端也不会停止）： bash
运行
nohup ./one-api --port 3000 --log-dir ./logs > output.log 2>&1 &- 命令解释：
nohup：让程序在后台一直运行--port 3000：指定程序使用 3000 端口（类似房间号）--log-dir ./logs：日志存到刚才创建的 logs 文件夹
- 命令解释：
-
启动后，终端会显示一个进程号（比如
[1] 12345），表示启动成功
步骤 5：查看 WSL 的 IP 地址（关键）
-
在 Ubuntu 终端输入以下命令，找到 WSL 的 IP： bash
运行
ip addr | grep eth0 -
找到类似
inet 172.28.xx.xx的内容，后面的172.28.xx.xx就是 WSL 的 IP 地址（记下来，比如172.28.35.100）
步骤 6：在 Windows 浏览器中访问 one-api
- 打开 Windows 的浏览器（Edge/Chrome 均可）
- 在地址栏输入：
http://刚才记的IP:3000（比如http://172.28.35.100:3000） - 首次登录：
- 用户名：
root - 密码：
123456 - 登录后建议立即修改密码（点击右上角头像→设置）
- 用户名：
步骤 7：创建渠道和令牌（必做）
7.1 创建渠道（连接大模型）
- 登录后，左侧菜单点击【渠道】→【新建渠道】
- 填写信息：
- 渠道名称：随便起（比如 "通义千问"）
- 模型类型：选择你要用的大模型（比如 "通义千问"）
- API Key：填写你从大模型官网申请的真实 APIKey（比如从阿里通义千问官网申请的密钥）
- 其他默认，点击【提交】
7.2 创建令牌（供代码调用）
- 左侧菜单点击【令牌】→【新建令牌】
- 填写信息：
- 令牌名称：随便起（比如 "我的令牌"）
- 权限：默认全选
- 点击【提交】
- 保存生成的令牌（类似
sk-xxxxxx），后面代码里会用到
停止 one-api 的方法（如需）
-
在 Ubuntu 终端输入以下命令找到进程： bash
运行
ps aux | grep one-api -
找到类似
./one-api --port 3000的进程，记录前面的进程号（比如12345） -
输入命令停止： bash
运行
kill 12345 # 把12345换成你的进程号
常见问题
- 浏览器访问不了？
- 检查 IP 是否正确（重新执行
ip addr | grep eth0确认） - 检查程序是否在运行（执行
ps aux | grep one-api看看有没有进程）
- 检查 IP 是否正确（重新执行
- 忘记密码？
- 停止程序后，删除
data文件夹（rm -rf data），重新启动程序会恢复默认密码
- 停止程序后，删除