README_zh.md
Rama main · réplica de lectura del repositorio original.
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/assets/liaison-brand-rays-dark.svg" />
<img src="docs/assets/liaison-brand-rays-light.svg" width="270" height="88" alt="Liaison" />
</picture>
> **可自托管的私有应用、大模型与 AI Agent 访问平台。**
通过主动出站的连接器接入私有服务，提供浏览器工作台、按权限分享的 API，以及上下文感知的 AI 辅助。
[](https://github.com/liaisonio/liaison/actions/workflows/go.yml)
[](https://github.com/liaisonio/liaison/releases)
[](https://github.com/liaisonio/liaison/releases)
[](go.mod)
[](web/package.json)
[](web/package.json)
[](web/vite.config.ts)
[](web/tailwind.config.cjs)
[](#contributing)
[English](./README.md) | 简体中文 | [日本語](./README_ja.md) | [한국어](./README_ko.md) | [Español](./README_es.md) | [Français](./README_fr.md) | [Deutsch](./README_de.md)
[官网](https://liaison.cloud) · [产品文档](https://liaison.cloud/zh/docs/get-started/introduction) · [产品能力](#产品能力) · [安装](#安装) · [访问协议](#支持的访问协议) · [Agent 模型](#agent-模型提供方) · [产品展示](#产品展示) · [社区](#社区)
## 产品能力
- 🤖 **本地大模型访问** — 通过认证 API 与浏览器在线体验分享本地模型。
- 🔑 **可控的 API 分享** — 按模型授权密钥、设置 Token 配额、撤销访问并查看用量。
- 🤖 **AI Agent 访问** — 在浏览器中使用设备上的 Codex 与 Claude Code，支持会话续聊、执行过程和权限确认。
- 💻 **IDE 工作台** — 通过 code-server 在浏览器中编辑项目、使用终端与扩展。
- ✨ **工作流中的 AI** — 在用户权限内读取终端输出、辅助编写命令和查询数据库，需要审批的操作先确认。
- 💬 **用对话查询资源** — 查找权限范围内的连接器、设备与应用。
- 🔌 **主动出站连接器** — 接入私有设备，无需在设备上开放入站端口。
- 🔐 **应用访问** — 接入 TCP、HTTP、HTTPS、WebSocket 与 SSH 服务，独立配置访问策略。
- 🖥️ **浏览器工作台** — 在浏览器中使用终端、远程桌面、数据库与缓存。
- 📁 **文件与对象浏览** — 通过 SFTP 管理文件，浏览 S3 兼容存储（只读）。
- 🔎 **应用发现** — 探测设备上的已有服务，并从控制台登记应用。
- 👥 **身份与权限** — 管理用户与资源，通过 Casbin 执行授权。
- 🛡️ **防火墙策略** — 按来源 IP 或 CIDR 限制 TCP 和 HTTP 访问。
- 📋 **日志与审计** — 查看管理操作及支持审计的应用会话。
- 📦 **私有化部署** — 在自己的 Linux 服务器上运行完整控制平面。
## 安装
下载自带所有镜像的 Docker 离线包，解压后运行安装脚本（需要 Docker 20.10+ 及 Compose）：
```bash
wget https://github.com/liaisonio/liaison/releases/download/v1.15.4/liaison-1.15.4-linux-amd64.tar.gz
tar -xzf liaison-1.15.4-linux-amd64.tar.gz
cd liaison-1.15.4-linux-amd64
./install.sh
```
安装完成后访问 `https://<服务器地址>`，初始登录信息会由安装脚本输出。
## 支持的访问协议
通过 Liaison 访问已有的私有服务。
<table>
<tr><th align="left">SSH / SFTP</th><td><img src="docs/assets/integrations/readme/ssh.svg" width="40" height="40" alt="SSH / WebSSH" title="SSH / WebSSH" /> <img src="docs/assets/integrations/readme/sftp.svg" width="40" height="40" alt="WebSFTP" title="WebSFTP" /></td></tr>
<tr><th align="left">Desktop</th><td><img src="docs/assets/integrations/windows.svg" width="40" height="40" alt="WebRDP" title="WebRDP" /> <img src="docs/assets/integrations/vnc.png" width="40" height="40" alt="WebVNC" title="WebVNC" /></td></tr>
<tr><th align="left">SQL databases</th><td><img src="docs/assets/integrations/mysql.svg" width="40" height="40" alt="WebMySQL" title="WebMySQL" /> <img src="docs/assets/integrations/mariadb.svg" width="40" height="40" alt="WebMariaDB" title="WebMariaDB" /> <img src="docs/assets/integrations/postgresql.svg" width="40" height="40" alt="WebPostgreSQL" title="WebPostgreSQL" /> <img src="docs/assets/integrations/sqlserver.svg" width="40" height="40" alt="WebSQLServer" title="WebSQLServer" /> <img src="docs/assets/integrations/oracle.svg" width="40" height="40" alt="WebOracle" title="WebOracle" /> <img src="docs/assets/integrations/clickhouse.svg" width="40" height="40" alt="WebClickHouse" title="WebClickHouse" /></td></tr>
<tr><th align="left">Data & search</th><td><img src="docs/assets/integrations/mongodb.svg" width="40" height="40" alt="WebMongoDB" title="WebMongoDB" /> <img src="docs/assets/integrations/elasticsearch.svg" width="40" height="40" alt="WebElasticsearch" title="WebElasticsearch" /> <img src="docs/assets/integrations/opensearch.svg" width="40" height="40" alt="WebOpenSearch" title="WebOpenSearch" /></td></tr>
<tr><th align="left">Cache</th><td><img src="docs/assets/integrations/redis.svg" width="40" height="40" alt="WebRedis" title="WebRedis" /> <img src="docs/assets/integrations/memcached.svg" width="40" height="40" alt="WebMemcached" title="WebMemcached" /></td></tr>
<tr><th align="left">Storage</th><td><img src="docs/assets/integrations/readme/s3.svg" width="40" height="40" alt="WebS3 (S3-compatible)" title="WebS3 (S3-compatible)" /></td></tr>
<tr><th align="left">LLM upstream protocols</th><td><picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/integrations/readme/openai-dark.svg" /><img src="docs/assets/integrations/readme/openai-light.svg" width="40" height="40" alt="OpenAI-compatible" title="OpenAI-compatible" /></picture> <img src="docs/assets/integrations/anthropic.svg" width="40" height="40" alt="Anthropic Messages" title="Anthropic Messages" /> <picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/integrations/readme/ollama-dark.svg" /><img src="docs/assets/integrations/readme/ollama-light.svg" width="40" height="40" alt="Ollama" title="Ollama" /></picture></td></tr>
<tr><th align="left">Web / TCP</th><td><img src="docs/assets/integrations/readme/web.svg" width="40" height="40" alt="HTTP / HTTPS / WebSocket" title="HTTP / HTTPS / WebSocket" /> <img src="docs/assets/integrations/readme/tcp.svg" width="40" height="40" alt="TCP" title="TCP" /></td></tr>
</table>
LLM 上游支持 **OpenAI-compatible**、**Anthropic Messages** 和 **Ollama**。对外提供 OpenAI-compatible 接口；Anthropic 上游另支持原生 Messages 接口。图标表示可访问的已有服务，不代表 Liaison 捆绑部署这些产品；数据库和桌面图标指浏览器工作台，不代表原生数据库、RDP 或 VNC 服务端监听。
## Agent 模型提供方
为 Liaison 内置 Agent 配置模型，独立于上述服务访问能力。
<table>
<tr>
<th align="left">模型</th>
<td><picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/integrations/readme/openai-dark.svg" /><img src="docs/assets/integrations/readme/openai-light.svg" width="40" height="40" alt="OpenAI" title="OpenAI" /></picture> <img src="docs/assets/integrations/anthropic.svg" width="40" height="40" alt="Anthropic / Claude" title="Anthropic / Claude" /> <img src="docs/assets/integrations/gemini.svg" width="40" height="40" alt="Google Gemini" title="Google Gemini" /> <img src="docs/assets/integrations/deepseek.svg" width="40" height="40" alt="DeepSeek" title="DeepSeek" /> <picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/integrations/readme/zhipu-dark.svg" /><img src="docs/assets/integrations/readme/zhipu-light.svg" width="40" height="40" alt="Z.ai / GLM" title="Z.ai / GLM" /></picture> <picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/integrations/readme/kimi-dark.svg" /><img src="docs/assets/integrations/readme/kimi-light.svg" width="40" height="40" alt="Moonshot / Kimi" title="Moonshot / Kimi" /></picture> <img src="docs/assets/integrations/minimax.svg" width="40" height="40" alt="MiniMax" title="MiniMax" /> <picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/integrations/readme/mimo-dark.svg" /><img src="docs/assets/integrations/readme/mimo-light.svg" width="40" height="40" alt="Xiaomi MiMo" title="Xiaomi MiMo" /></picture></td>
</tr>
</table>
支持以上 8 家预置厂商，以及自定义 OpenAI 兼容服务。
## 产品展示
### 本地大模型访问
### Web SSH
在可审计的浏览器终端中工作，让关联当前会话的 Agent 读取输出并辅助编写命令。
### 私有 Web 应用
通过 Liaison 访问媒体服务及其他内部 Web 应用。
### 私有 AI 助手
无需暴露私有网络，也能安全访问内部 AI 工具。
### Web MySQL
查看表结构、执行 SQL，让会话 Agent 查询并解释结果，需要审批的操作先确认。
### Web MongoDB
无需本地客户端即可浏览集合，让会话 Agent 执行已批准的查询并解释文档。
### Web VNC
通过受管的浏览器会话访问私有 VNC 桌面。
### Web RDP
使用同一套访问流程连接 RDP 桌面。
## 文档
- [Docker 部署](deploy/docker/README.md)
- [API 文档](docs/swagger/swagger.yaml)
- [版本发布](https://github.com/liaisonio/liaison/releases)
- [问题反馈](https://github.com/liaisonio/liaison/issues)
- [社区讨论](https://github.com/liaisonio/liaison/discussions)
## 社区
<div align="center">
<p align="center">
<img
src="docs/assets/readme/wechat-community-20261027.jpg"
width="260"
alt="Liaison 微信开发者社区二维码"
/>
</p>
使用微信扫码加入 Liaison 开发者社区。
本期群二维码有效期至 2026 年 11 月 3 日前；如已过期，请通过 [社区讨论](https://github.com/liaisonio/liaison/discussions) 联系我们获取新二维码。
</div>
<a id="contributing"></a>
## 贡献
Liaison 正在持续迭代，欢迎一起开发本仓库中的自托管版本。
- AI Agent：工具集成、会话管理与协作。
- 应用访问：SSH、文件、数据库、IDE、远程桌面与模型 API。
- 跨平台支持：Linux、macOS、Windows 的安装与兼容性。
- 使用体验：界面改进、多语言与文档。
较大的改动请先开 Issue 讨论范围。PR 请聚焦单一主题，并说明验证方式；不要包含凭据、私人数据或特定环境的部署信息。可以直接在 GitHub 参与开发，不需要先加群。
欢迎提交问题、功能建议、文档改进与代码贡献。可以从 [Issues](https://github.com/liaisonio/liaison/issues) 或 [Pull Requests](https://github.com/liaisonio/liaison/pulls) 开始。
## 许可证
Liaison 使用 [GNU Affero 通用公共许可证 v3.0](LICENSE) 开源许可证。