先明确：群晖上部署的不是模型本体

OpenRouter 的核心价值是把不同 AI 模型统一成兼容 OpenAI 风格的接口，方便在一个入口里切换模型。它本身不是需要安装到群晖里的本地大模型，也不会把模型文件下载到 NAS。群晖 Docker 部署的常见做法，是安装一个可视化聊天客户端或接口袋里服务，让它使用 OpenRouter 的 API 地址和密钥完成调用。

对普通用户来说，最容易落地的方案是部署 Open WebUI 这类网页端 AI 工具，再把接口地址指向 OpenRouter。这样手机、电脑在局域网内打开群晖地址，就能使用多个模型。对开发者来说，也可以部署 LiteLLM 之类的袋里容器，把 OpenRouter 包装成内部统一接口，供脚本、工作流或业务系统调用。

适用场景与准备工作

这种部署方式适合三类人：一是希望在群晖上搭建家庭或团队 AI 入口；二是已有多个模型调用需求，希望用 OpenRouter 统一管理；三是想把 AI 工具接入自动化流程，但不想在每台电脑上单独配置环境。需要注意的是，实际推理仍发生在远端模型服务侧，群晖主要承担网页访问、配置保存和请求转发。

开始前请准备四项内容：第一，群晖系统已安装 Container Manager，旧版本系统中可能叫 Docker；第二，群晖可以正常访问外部 HTTPS 接口；第三，已在 OpenRouter 控制台创建 API Key；第四，准备一个空文件夹用于保存容器数据，例如 /docker/openwebui。建议提前确认群晖内存不少于 2GB 可用空间，虽然客户端容器不算重，但长期运行仍需要稳定资源。

方案一：使用 Open WebUI 连接 OpenRouter

进入群晖 Container Manager，打开“映像”页面，搜索或手动填写 ghcr.io/open-webui/open-webui:main，下载完成后创建容器。端口映射建议设置为本地 3000 对容器 8080，例如群晖地址为 192.168.1.10，部署后访问 http://192.168.1.10:3000 即可打开页面。

卷映射建议把群晖目录 /docker/openwebui 映射到容器内 /app/backend/data，用来保存用户、会话和配置。环境变量是关键：OPENAI_API_BASE_URL 填 https://openrouter.ai/api/v1，OPENAI_API_KEY 填你的 OpenRouter 密钥。如果界面或版本支持多接口配置，也可以在后台设置中手动添加兼容接口，接口地址同样使用上述地址。

容器创建完成后启动，首次访问页面会要求创建管理员账号。登录后进入设置，检查模型供应方是否为 OpenAI compatible 或自定义兼容接口。模型名称可填写 OpenRouter 支持的模型标识，例如 openai/gpt-4o-mini、anthropic/claude-3.5-sonnet 等，实际可用列表以 OpenRouter 控制台显示为准。发送一句简单问题，如“用三点概括 Docker 的作用”，若能正常返回，即表示链路成功。

方案二：部署 LiteLLM 作为接口袋里

如果你的目标不是聊天界面，而是给多个工具提供统一 API，可以选择 LiteLLM。下载镜像 ghcr.io/berriai/litellm:main-stable，端口可映射为本地 4000 对容器 4000。它通常需要配置文件定义模型映射，也可以通过环境变量读取密钥。适合有一定技术基础的用户，因为需要维护模型别名、日志级别和访问规则。

一个常见思路是把内部工具统一请求 http://群晖IP:4000/v1/chat/completions，再由 LiteLLM 转到 OpenRouter。这样以后更换模型、调整默认参数时，只需要改袋里配置，不必逐个修改客户端。团队环境中还可以按项目设置不同模型别名，例如 fast-chat 对应低延迟模型，long-context 对应长文本模型，便于管理。

关键配置参数说明

OPENAI_API_BASE_URL：接口基础地址，使用 OpenRouter 时通常为 https://openrouter.ai/api/v1，末尾不要随意添加多余路径。OPENAI_API_KEY：访问密钥，必须保密，不要写进公开笔记、截图或共享文档。端口映射：Open WebUI 默认容器端口为 8080，LiteLLM 常用 4000，本地端口可按实际占用情况调整。卷映射：务必设置持久化目录，否则容器删除后账号和聊天记录可能丢失。

模型名称：OpenRouter 的模型标识通常带有供应方前缀，填写错误会返回模型不存在或无权限。温度参数 temperature 决定回答发散程度，日常问答可设 0.7 左右，严谨总结可设 0.2 到 0.5。max_tokens 决定单次输出长度，设置过小会导致回答中断，设置过大可能增加消耗并延长等待时间。

运行测试方法

第一种测试是网页测试。打开 Open WebUI，新建会话，选择一个已配置模型，输入简短问题。如果页面能持续显示生成内容，说明容器、接口地址、密钥和模型名称基本正常。若一直转圈，先查看容器日志，再检查群晖网络和密钥。

第二种测试是接口测试。在电脑终端发起 POST 请求到 OpenRouter 的 /chat/completions 接口，请求头包含 Authorization: Bearer 加你的密钥，Content-Type 使用 application/json，请求体包含 model、messages 等字段。返回内容中如果出现 choices 字段，说明接口正常。若通过 LiteLLM 测试，则把地址换成群晖本地端口对应的 /v1/chat/completions。

第三种测试是稳定性测试。连续发送三到五个不同长度的问题，观察响应速度、是否超时、容器 CPU 和内存占用。群晖只是承载客户端，资源占用通常不高；若内存明显上涨，建议升级镜像或减少同时在线用户数。

常见问题排查

页面打不开：优先检查端口映射是否正确，群晖防火墙是否允许访问该端口，容器状态是否为运行中。若端口被其他服务占用，可把本地端口改为 3001、8088 等未使用端口。

提示 401 或认证失败：通常是 API Key 填错、复制时多了空格，或密钥已被删除。重新生成密钥后，更新容器环境变量并重启。不要把密钥直接发给他人协助排查，可用部分打码截图说明问题。

提示模型不可用：检查模型标识是否完整，是否在 OpenRouter 当前账号中可访问。有些模型会调整名称、上下文长度或调用条件，建议到控制台复制标准名称，不要凭记忆手写。

回答很慢或中断：可能与所选模型繁忙、输出长度过大、网络波动有关。可先切换轻量模型验证链路，再逐步增加上下文长度。若经常超时，减少并发请求，避免多个客户端同时提交长文本任务。

安全边界与实用建议

不要把 Open WebUI 直接暴露到公网，尤其不要使用弱口令。若确需远程访问，建议通过群晖自带安全访问方案、反向袋里与强认证组合，并开启 HTTPS。管理员账号、API Key、访问日志都应妥善管理，离职成员或临时测试账号使用后要及时清理。

生产或团队场景中，建议把聊天测试和业务调用分开使用不同密钥，便于统计消耗和定位异常。不要在提示词中提交敏感合同、个人证件、客户隐私等内容，除非已经完成脱敏并确认合规要求。OpenRouter 只是接口路由层，数据会发送到对应模型服务侧处理，使用前应了解相关服务条款。

维护方面，建议每月检查一次镜像更新，但不要在重要使用时段直接升级。升级前先备份 /docker/openwebui 目录，记录当前镜像版本、环境变量和端口配置。若升级后异常，可回退到旧镜像标签并恢复数据目录。对于长期运行的群晖，给容器设置自动重启策略可以提升可用性，但仍要定期查看日志，避免错误请求反复重试造成不必要消耗。

总体来看，群晖 Docker 部署 OpenRouter 相关工具的关键不在“安装模型”，而在搭建稳定、安全、易维护的调用入口。只要接口地址、密钥、模型名称和端口映射配置正确，就能用较低成本把 NAS 变成家庭或小团队的 AI 工作台。

《夸克》非常好用的免费AI浏览器

下载APP查看