通过 Tailscale 访问本地 AI

TSLink 为已有模型 HTTP API 提供私有 HTTPS 地址。后端负责推理，TSLink 转发流量。获准设备可把地址配置到 Ollama client 或兼容应用中。

Shell 示例使用 bash/zsh 与 curl。

先检查后端

安装 TSLink，在发布主机自行运行 Ollama。需要本地推理时，选择并下载本地模型。分享前检查 API：

curl http://localhost:11434/api/tags

响应列出已安装的模型。无法连接时先修复后端；列表为空时仍需安装模型才能推理。

注册私有模型地址

将邮箱替换为自己的 Tailscale 登录账户：

tslink add model --proxy localhost:11434 --allow you@example.com
tslink url model --wait

按提示完成节点入网。访问设备需要 Tailscale，网络策略也必须允许连接。使用返回的准确 URL；同名 add 会替换服务设置，修改时需重复所有要保留的选项。

从获准的访问设备执行：

MODEL_URL='PASTE_THE_EXACT_URL_RETURNED_BY_TSLINK'
curl "$MODEL_URL/api/tags"

选择已安装的模型名称。Ollama 只兼容部分 OpenAI API 功能，需核对 client 使用的路由与参数。Client 的 API-key 字段不能替代 Tailscale 访问检查。

添加网页界面或同事

local-ai-suite 模板分别注册 ollama（localhost:11434）和 open-webui（localhost:8080）节点。它是上述手工 model 注册的另一种选择：

tslink template apply local-ai-suite
tslink template apply local-ai-suite --yes
tslink url ollama --wait
tslink url open-webui --wait

先预览；模板保留已有条目。两个应用都需自行安装与配置，包括 Open WebUI 的模型连接。tslink apps list 的 recipes 提供更多应用建议。

给另一个人开放私有模型服务一小时，可以用人员授权：

tslink people add alice@example.com --apps model --for 1h

若选择模板，将 model 换成 ollama。首次人员授权会收紧该应用的访问范围，也要配置自己的访问权限。

明确数据路径

TSLink 不加载模型、不实现 RAG、不索引文档，也不阻止出站请求。Localhost Ollama API 仍可能使用云端模型，远程 agent 也可能在其他主机处理接收的数据。应按数据敏感程度选择本地模型、数据存储和应用日志设置。

TSLink 的 MCP 管理分享；agent 的推理连接需单独使用模型地址配置。其他主机上的 agent 仍需能访问 tailnet。模型 API 应保持私有；Funnel 没有 TSLink 调用者身份检查。

HTTP 响应支持流式转发。上传默认限制为 32 MiB 请求体与 30 秒无读取进展窗口，这不是总推理时限。大输入需明确配置请求限制；后端与 client 的限制也仍适用。

相关：Agent/MCP 配置 · 健康检查。

来源：TSLink 本地 AI 指南、Ollama 模型列表、Ollama API 兼容说明。