Docker部署开源LinkAI大模型安全接入网关服务平台
Docker部署开源LinkAI大模型安全接入网关服务平台
一、LinkAI介绍
1.1 LinkAI简介
link-ai 是一款面向企业和个人设计的大模型安全接入网关，通过双层脱敏、链式审计、零信任令牌、容灾自愈及多协议透传技术，构建全链路隐私防护与稳定调用体系，确保 AI 调用安全合规、稳定高效。
1.2 LinkAI主要特点
- 双层脱敏引擎：管理员强制脱敏+用户自定义规则，请求前自动替换敏感数据，杜绝上游泄露。
- 链式哈希审计日志：哈希链防篡改，完整记录请求/响应轨迹，满足合规审计需求。
- 零信任令牌体系：成员独立令牌+分层配额管控，超额自动熔断，平衡安全与灵活性。
- 全链路容灾自愈：三态熔断器+健康探测，智能切换备用提供商，保障调用不间断。
- 多协议原生透传：兼容 OpenAI、Anthropic 等协议，业务端零改造接入，降低集成成本。
二、本次实践规划
2.1 本地环境规划
本次实践为个人测试环境，操作系统版本为 Ubuntu 24.04.2 LTS。
| hostname | IP地址 | 操作系统版本 | Docker版本 | 部署项目 | 备注 |
|---|---|---|---|---|---|
| jeven | 192.168.3.88 | Ubuntu 24.04.2 LTS | 28.5.0 | LinkAI | —— |
2.2 本次实践介绍
1.本次实践部署环境为个人测试环境，生产环境请谨慎；
2.在Docker环境下部署LinkAI大模型安全接入网关服务平台。
三、本地环境检查
3.1 检查Docker服务状态
检查Docker服务是否正常运行，确保Docker正常运行。
root@jeven:~# systemctl status docker
● docker.service - Docker Application Container Engine
Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; preset: enabled)
Active: active (running) since Thu 2026-02-05 00:27:40 CST; 1s ago
TriggeredBy: ● docker.socket
Docs: https://docs.docker.com
Main PID: 841698 (dockerd)
Tasks: 65
Memory: 73.5M (peak: 77.1M)
CPU: 975ms
CGroup: /system.slice/docker.service
3.2 检查Docker版本
检查Docker版本
root@jeven:~# docker -v
Docker version 28.5.0, build 887030f
3.3 检查docker compose 版本
检查Docker compose版本，确保2.0以上版本。
root@jeven:~# docker compose version
Docker Compose version v2.39.4
四、拉取LinkAI镜像
下载LinkAI镜像，执行以下命令：
root@jeven:~# docker pull star7th/link-ai:sha-21623a5
sha-21623a5: Pulling from star7th/link-ai
17a39c0ba978: Already exists
6eee3c54a80b: Pull complete
8ff35ae9194b: Pull complete
6c489081fec4: Pull complete
df9a987ba92d: Pull complete
ef9134b6793f: Pull complete
05bc6fa96b71: Pull complete
Digest: sha256:e3308fe1723ee3f381e21c6dcb3332c33c8a2b79f03bc37a57b4c6c0745e4f74
Status: Downloaded newer image for star7th/link-ai:sha-21623a5
docker.io/star7th/link-ai:sha-21623a5
五、部署LinkAI服务
5.1 创建部署目录
- 创建部署目录
mkdir -p /data/linkai/data && cd /data/linkai
- 在测试环境中，为了方便操作，我们直接为挂载目录设置了完全权限。但在生产环境中，请务必根据实际安全需求，配置更精细、严格的权限控制方案。
chmod -R 777 /data/linkai
5.2 生成随机密钥
执行以下命令，生成随机密钥，在后续步骤使用。
root@jeven:/data/linkai# openssl rand -hex 32
2056e3e9767ef88e6bba236c47596a0bf187a9e714554f44654e97c3491cee52
5.3 创建LinkAI容器
如果想要使用docker-cli方式部署，可参考以下命令部署。（可选）
docker run -d \
--name=link-ai \
--restart=always \
-p 3333:3333 \
-v $(pwd)/data:/app/data \
-e DOCKER_SETUP=true \
-e NEXTAUTH_SECRET=2056e3e9767ef88e6bba236c47596a0bf187a9e714554f44654e97c3491cee52 \
star7th/link-ai:latest
本次实践我们采用 Docker Compose 方式进行部署，这也是我推荐的方式。首先我们需要创建并编辑
docker-compose.yaml文件，请注意宿主机映射端口可根据您的实际情况自行设置，务必避免端口冲突。
vim docker-compose.yaml
version: '3'
services:
link-ai:
image: star7th/link-ai:sha-21623a5
container_name: link-ai
restart: always
ports:
- "3333:3333"
volumes:
- /data/linkai/data:/app/data
environment:
- DOCKER_SETUP=true
- NEXTAUTH_SECRET=2056e3e9767ef88e6bba236c47596a0bf187a9e714554f44654e97c3491cee52
5.4 创建LinkAI容器
执行以下命令，创建LinkAI容器。
docker compose up -d
5.5 查看LinkAI容器状态
检查LinkAI容器运行状态，确保LinkAI容器正常启动。
root@jeven:/data/linkai# docker compose ps
WARN[0000] /data/linkai/docker-compose.yaml: the attribute `version` is obsolete, it will be ignored, please remove it to avoid potential confusion
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
link-ai star7th/link-ai:sha-21623a5 "./startup.sh" link-ai 3 minutes ago Up 3 minutes 0.0.0.0:3333->3333/tcp, [::]:3333->3333/tcp
5.6 检查LinkAI容器日志
检查容器运行日志，确保LanLens服务正常运行。
docker compose logs
六、访问LinkAI服务
6.1 访问LinkAI初始页
浏览器地址：
http://<个人的服务器IP>:3333，访问LinkAI初始页。如果无法访问，请确保宿主机的防火墙已关闭或已放行相关端口，对于云服务器还需配置相应的安全组规则。
6.2 系统初始化
我们在LinkAI初始页设置账号与密码，进行系统初始化。
七、总结
本次实践借助 Docker 顺利完成了 LinkAI 大模型安全接入网关的部署，充分展现了其便捷高效的容器化交付能力。依托双层脱敏、链式审计及零信任令牌等核心机制，该平台为 AI 调用构建了严密的隐私安全防线。全链路容灾与多协议透传功能的加持，进一步保障了业务接入的流畅性与服务调用的稳定性。LinkAI 为企业及个人开发者提供了一套合规、可控且易于维护的本地化大模型接入解决方案。
- 点赞
- 收藏
- 关注作者
评论（0）