Windows 便携部署包

9router 使用介绍

把 9router 放到 Windows 机器上，双击启动，就能在本机提供兼容 OpenAI API 的统一模型入口。

开始使用查看接入参数

http://localhost:20128/dashboard

Endpoint/v1

Port20128

StatusRunning

Current route provider / model / combo

Ready

它解决什么

一个本地模型路由入口

便携运行

包内自带 Node.js runtime，目标机器通常不需要提前安装 Node.js。

统一接入

给 Claude Code、Codex、Cline、Cursor、OpenClaw 等工具提供统一的 API Endpoint。

本地管理

通过 Dashboard 管理 provider、model、combo、API Key 和运行状态。

Quick start

快速启动

第一次启动会自动生成运行配置和初始密码。登录后建议尽快修改密码。

复制目录

把整个 91router 或 9router 目录复制到目标机器，例如 D:\91router。

双击启动

运行 start-91router.cmd。打开的控制台窗口就是服务进程窗口，运行期间保持打开。

打开 Dashboard

浏览器访问 http://localhost:20128/dashboard。

使用初始密码登录

初始密码在 config\initial-password.txt。登录后到界面里修改密码。

For CLI tools

接入 Claude Code、Codex、Cursor 等工具

Endpointhttp://localhost:20128/v1
API Key从 9router Dashboard 复制
Model填写 Dashboard 中配置的 provider/model 或 combo

如果部署在局域网机器上供其他设备访问，把 localhost 换成该机器的局域网 IP，并确认 Windows 防火墙允许对应端口。

Files

常用文件和目录

start-91router.cmd启动服务

stop-91router.cmd停止当前端口上的服务

config\.env本机运行配置

data\SQLite、账号、API Key、日志等运行数据

logs\启动脚本日志和 PID 文件

exports\数据导出包默认保存目录

Config

常见配置项

PORT

默认 20128。端口冲突时改成其他端口。

BASE_URL

服务自己的地址，修改端口后同步调整。

NEXT_PUBLIC_BASE_URL

前端显示和客户端配置使用的地址。

DATA_DIR

运行数据目录。默认在安装目录下的 data。

HTTP_PROXY / HTTPS_PROXY

目标机器访问上游模型需要代理时再填写。

修改 config\.env 后，先停止当前服务，再重新运行 start-91router.cmd。

Backup

导出和导入 DATA_DIR

导出的数据包可能包含 API Key、OAuth token、请求日志、machine-id 和私有密钥，只适合迁移到可信机器。

从当前便携包导出

powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\export-data.ps1

从旧部署导出

powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\export-data.ps1 -SourceDataDir "D:\Program Files\9router\data" -EnvPath "D:\Program Files\9router\.env"

导入数据包

.\stop-91router.cmd
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\import-data.ps1 -ArchivePath ".\exports\91router-data-YYYYMMDD-HHMMSS.zip"
.\start-91router.cmd

Troubleshooting

故障排查

启动失败

查看 logs\server-*.err.log。

端口冲突

修改 PORT、BASE_URL 和 NEXT_PUBLIC_BASE_URL。

旧 API Key 不可用

确认导出时传入了旧部署的 -EnvPath，并在导入时合并了密钥配置。

页面能打开但模型不可用

检查 Dashboard 的 provider 配置、网络连接和代理变量。