企业本地网关部署

准备一台企业 Linux 电脑

选择一台 Linux 电脑作为企业本地网关。员工电脑与这台 Linux 电脑需要处于同一局域网，Linux 电脑还需要能够访问 LinkAI ModelHub。

• 员工访问地址：http://linux-ip:18080/v1
• 上游 ModelHub 地址：https://api.linknlink.tech/modelhub/v1
• 建议为这台 Linux 电脑设置固定局域网 IP

hostname -I

确认系统与架构并下载安装包

Debian 或 Ubuntu 使用 DEB；RHEL、CentOS、Rocky Linux 等兼容系统使用 RPM。x86_64 或 amd64 选择 x86，aarch64 或 arm64 选择 ARM64。

uname -m

wget -O apiproxy_latest_amd64.deb https://oss.linknlink.vip/homeclaw/apiproxy_latest_amd64.deb

wget -O apiproxy_latest_arm64.deb https://oss.linknlink.vip/homeclaw/apiproxy_latest_arm64.deb

wget -O apiproxy-latest.x86_64.rpm https://oss.linknlink.vip/homeclaw/apiproxy-latest.x86_64.rpm

wget -O apiproxy-latest.aarch64.rpm https://oss.linknlink.vip/homeclaw/apiproxy-latest.aarch64.rpm

安装并启动网关服务

根据安装包格式选择对应命令。ARM64 用户需要把第一行中的文件名替换为已下载的 ARM64 或 aarch64 文件名。

sudo dpkg -i apiproxy_latest_amd64.deb
sudo systemctl daemon-reload
sudo systemctl restart apiproxy
sudo systemctl enable apiproxy
sudo systemctl status apiproxy --no-pager

sudo rpm -Uvh apiproxy-latest.x86_64.rpm
sudo systemctl daemon-reload
sudo systemctl restart apiproxy
sudo systemctl enable apiproxy
sudo systemctl status apiproxy --no-pager

状态显示 active，表示网关服务已运行。团队使用本地网关期间，请保持这台 Linux 电脑开机。

打开管理后台并修改密码

在浏览器打开 http://linux-ip:18080。初始账号和密码均为 admin，首次登录后请立即修改管理员密码。

图 1修改管理员密码

配置 LinkAI ModelHub

在网关后台填写上游 LinkAI API Key、Base URL 和默认模型。上游 API Key 只保存在 Linux 网关电脑中，不需要分发给员工。

如果还没有 LinkAI API Key，可以登录 LinknLink AI 创建；已有有效 Key 可直接使用。

获取 API Key

图 2配置 LinkAI ModelHub

创建并分配员工本地 API Key

打开“本地 API Key”页面，以员工姓名、设备名称或项目名称作为 Key 名称。若不需要限制模型，“允许模型”可以留空。

图 3创建员工本地 API Key

最后只需向员工提供本地 sk-loc Key 和局域网 base_url。不要向员工分发网关中配置的上游 LinkAI API Key。