Linux 进阶配置

普通用户首次安装只需要完成 Linux 安装。本页用于交互式安装、修改目录和端口、选择服务管理器、配置 NexusDock 或只安装二进制。

Alpine 与极简系统

系统缺少 Bash 或 curl 时，先运行引导脚本：

wget -O /tmp/install-agentdock-bootstrap.sh \
  https://github.com/uvwt/agentdock/releases/latest/download/install-linux-bootstrap.sh
sudo sh /tmp/install-agentdock-bootstrap.sh

引导脚本只负责安装最小依赖并下载正式安装器，后续仍使用预编译 AgentDock。

交互式安装

不设置 AGENTDOCK_NONINTERACTIVE 时，安装器会逐项询问配置：

curl -fsSL https://github.com/uvwt/agentdock/releases/latest/download/install-linux.sh \
  -o /tmp/install-agentdock.sh
bash /tmp/install-agentdock.sh

普通部署保持 binary 即可。source 和 auto 只用于开发或预编译产物不可用的调试场景。

默认目录

安装目录      /opt/agentdock
运行数据目录  /srv/agentdock
环境文件      /etc/agentdock/agentdock.env
服务用户      agentdock
监听地址      127.0.0.1:8765

典型 systemd 安装会生成：

/opt/agentdock/bin/agentdock
/srv/agentdock/.agentdock
/srv/agentdock/AgentDock
/etc/agentdock/agentdock.env
/etc/systemd/system/agentdock.service

OpenRC 会改为创建 /etc/init.d/agentdock。

非交互配置

自动化部署时可以通过环境变量覆盖默认值：

sudo env \
  AGENTDOCK_NONINTERACTIVE=true \
  AGENTDOCK_RELEASE_VERSION=latest \
  AGENTDOCK_PORT=8765 \
  bash /tmp/install-agentdock.sh

常用变量：

变量	用途
AGENTDOCK_RELEASE_VERSION	latest 或 vX.Y.Z
AGENTDOCK_SOURCE_DIR	二进制安装根目录
AGENTDOCK_DATA_DIR	状态和工作目录根目录
AGENTDOCK_ENV_FILE	服务环境文件
AGENTDOCK_SERVICE_NAME	systemd/OpenRC 服务名
AGENTDOCK_SERVICE_USER	低权限运行用户
AGENTDOCK_SERVICE_MANAGER	auto、systemd、openrc 或 none
AGENTDOCK_HOST	监听地址
AGENTDOCK_PORT	监听端口
AGENTDOCK_AUTH_TOKEN	自定义 Bearer Token
AGENTDOCK_NEXUS_ENDPOINT	NexusDock 地址
AGENTDOCK_NEXUS_TOKEN	NexusDock Token

不要把真实 Token 写进仓库。未提供 AGENTDOCK_AUTH_TOKEN 时，安装器会自动生成并写入 root-only 环境文件。

只安装二进制

不希望注册系统服务时：

sudo env \
  AGENTDOCK_NONINTERACTIVE=true \
  AGENTDOCK_SERVICE_MANAGER=none \
  bash /tmp/install-agentdock.sh

这种模式不会自动启动 AgentDock，需要手动运行 /opt/agentdock/bin/agentdock。

修改端口或 Token

编辑环境文件：

sudoedit /etc/agentdock/agentdock.env

修改后重启服务：

sudo systemctl restart agentdock
sudo systemctl status agentdock --no-pager

OpenRC 使用：

sudo rc-service agentdock restart
sudo rc-service agentdock status

查看日志

systemd：

sudo journalctl -u agentdock -n 100 --no-pager
sudo journalctl -u agentdock -f

OpenRC：

sudo tail -n 100 /var/log/agentdock.log /var/log/agentdock.err

更新

重新运行安装器即可替换二进制。运行数据和环境文件会保留。固定版本时设置：

sudo env \
  AGENTDOCK_NONINTERACTIVE=true \
  AGENTDOCK_RELEASE_VERSION=vX.Y.Z \
  bash /tmp/install-agentdock.sh

需要完全自行维护 systemd、环境文件、反向代理和 OAuth 时，阅读 Linux 手动部署。