第一步检查 Windows 版本与硬件要求WSL 2 及systemd的支持需要特定的 Windows 系统版本。按下Win R键输入winver并回车。确认系统版本Windows 11 所有版本均支持Windows 10 需为 Build 190412020年5月更新或更高版本。(版本低会有不能使用wsl2、不能配置wsl网络桥接问题)确认硬件支持虚拟化在 BIOS 中确保已启用 Intel VT-x 或 AMD-V 选项。第二步安装 Node.js 20FreeLLMAPI 基于 Node.js 构建要求版本在 20 以上。在 WSL 终端中执行以下命令安装 Node.js 22sudoaptupdatesudoaptinstall-ycurlcurl-fsSLhttps://deb.nodesource.com/setup_22.x|sudo-Ebash-sudoaptinstall-ynodejs安装完成后验证版本node -v和npm -v。第三步克隆项目与安装依赖在 WSL 中拉取代码并安装项目所需的依赖包gitclone https://github.com/tashfeenahmed/freellmapi.gitcdfreellmapinpminstallnpmrun build第四步生成加密密钥与环境配置复制环境变量模板文件cp.env.example .env生成一个随机的十六进制加密密钥并追加到.env文件中echoENCRYPTION_KEY$(node-econsole.log(require(crypto).randomBytes(32).toString(hex))).env第五步启用 systemd 并配置服务后台运行可选如果您希望通过systemctl命令将 FreeLLMAPI 配置为开机自启和后台常驻运行需先在 WSL 中启用systemd需 Windows 10 Build 19041 或 Windows 11在 WSL 中编辑配置文件sudo vi \etc\systemd\system。添加以下配置DescriptionFreeLLMAPI Self-hosted AI Gateway Afternetwork.target [Service] Typesimple # 替换为你的实际项目安装路径 WorkingDirectory/root/freellmapi # 确保使用 Node.js 20 环境 ExecStart/usr/bin/node server/dist/index.js Restarton-failure RestartSec10 # 设置环境变量systemd 不会自动加载 .env 文件需手动指定 EnvironmentFile/root/freellmapi/.env [Install] WantedBymulti-user.target保存退出重载服务sudosystemctl daemon-reloadsudosystemctl restart freellmapi验证FreeLLMApi启动sudo journalctl -u freellmapi -f第六步在 Windows 浏览器中访问在 Windows 宿主机上打开浏览器访问以下地址前端管理面板http://localhost:3001如果无法访问请尝试使用 WSL 的 IP 地址如http://WSL_IP:3001可通过ip addr命令获取。第七步配置秘钥与路由策略首次访问管理面板时创建一个管理员账号。在密钥页面添加各平台的免费 API Key如 Groq、Mistral、智谱 Z.ai 等。1. 官方密钥2. 自定义密钥在模型页面配置路由策略。复制页面顶部的统一 API Key格式为freellmapi-...用于后续代码调用。常见问题与提示端口被占用如果 3001 端口在 Windows 上被占用可以在 WSL 中修改配置文件更换端口。项目构建失败 由于wsl缺少构建工具需要执行命令sudo apt update apt install -y build-essential make python3