企业官网建设流程全解析

AgentDock 是一个面向 AI Agent 的独立工具运行层。它把文件、命令、Git、Skill、动态 MCP、浏览器自动化和任务执行等能力，通过标准 MCP 协议开放给 ChatGPT、Claude、Codex 等客户端，让你在网页对话里就能安全地操控本地电脑、远程服务器与容器——不消耗专用编程 Agent 额度。

本文是一份面向新手的多平台安装指南，覆盖 Docker、Linux、macOS、Windows 四种方式，并给出统一的连接方式选择与客户端接入步骤。照着做，5 分钟内即可让 AgentDock 在你的设备上跑起来。

普通用户直接使用官方安装包即可，无需下载源码、无需安装 Go。

🧭 安装前先选一种连接方式

不同使用场景对应三种连接方式，先想清楚再动手，能少走弯路：

无论哪种方式，安装完成后都要从控制面板或终端取得两样东西：

• MCP 地址：默认http://127.0.0.1:8765/mcp
• 认证信息：Bearer Token 或 OAuth 登录信息

⚠️ 公网访问必须保留认证，不要把 Token、OAuth 密码发到截图、Issue 或公开聊天。

🐳 方式一：Docker 部署（推荐服务器/容器党）

Docker 是部署最干净的方式，官方 Compose 文件已内置健康检查、日志轮转和持久化卷，见 docker-compose.yml。

1. 设置认证 Token（必填）

容器默认监听0.0.0.0，因此必须显式提供认证：

export AGENTDOCK_AUTH_TOKEN="你的一串随机Token"

2. 启动服务

docker compose up -d

3. 检查运行状态与日志

docker compose ps docker compose logs --tail=100 agentdock

4. 验证健康检查

curl -fsS http://127.0.0.1:8765/healthz

💡 改端口要注意两层：AGENTDOCK_PORT改的是容器内监听端口，若宿主端口映射仍是旧值，外部访问依旧会失败。改配置后请用docker compose up -d重建容器，而不是docker compose restart。详细原理见 core-skills/agentdock-user-guide/references/docker.md。

🐧 方式二：Linux 自动安装（systemd / OpenRC）

Linux 官方安装脚本会自动识别系统、下载校验 Release 载荷，并注册为 systemd 或 OpenRC 服务，见 scripts/install/install.sh。

1. 运行安装脚本

sh install.sh

安装过程会引导你选择环境文件路径、服务名、服务用户以及服务管理器（systemd / OpenRC / 不安装）。

2. 确认服务定义（关键）

默认环境文件是/etc/agentdock/agentdock.env，默认服务名为agentdock。修改前务必确认服务真正引用的路径：

systemctl cat agentdock

3. 重启并验证

sudo systemctl restart agentdock sudo systemctl status agentdock --no-pager curl -fsS http://127.0.0.1:8765/healthz

⚠️ 只改环境文件不等于生效，必须重启实际承载 Core 的服务进程。排障细节见 core-skills/agentdock-user-guide/references/linux.md。

🍎 方式三：macOS 图形安装（AgentDock.app）

macOS 推荐使用图形版AgentDock.app（DMG 拖入"应用程序"即可），由 App 统一管理后台 Core 的生命周期。

1. 运行并授权

打开 AgentDock.app，按提示完成后台服务注册。

2. 通过界面调整设置

优先使用 App 内的设置 / 高级设置界面，它会自动校验配置、原子写入并在失败时回滚，比手工改文件更安全。运行目录与配置位于：

$HOME/Library/Application Support/AgentDock/agentdock.env

3. 验证健康检查

curl -fsS http://127.0.0.1:8765/healthz

更多 macOS 配置与生效说明见 core-skills/agentdock-user-guide/references/macos.md。

🪟 方式四：Windows 图形安装程序

Windows 采用官方图形化 Setup 安装程序，见 scripts/install/install.ps1 与打包配置 packaging/windows/。

1. 运行安装程序

双击 Setup 安装程序，按向导完成。二进制默认安装在：

%LOCALAPPDATA%\AgentDock\bin

2. 打开控制面板配置

端口、日志、浏览器、ACP 等普通设置，都优先在控制面板里保存——它会校验新设置、重启 Core/Tunnel，失败时自动恢复旧状态。

3. 通过 CLI 验证（可选）

agentdock service status --runtime-root "$env:LOCALAPPDATA\AgentDock"

💡 不要手工迁移或解密 DPAPI 凭据文件，它们与 Windows 用户保护上下文绑定。完整说明见 core-skills/agentdock-user-guide/references/windows.md。

🔌 接入 AI 客户端（MCP 配置）

AgentDock 通过MCP Streamable HTTP提供工具能力。把 MCP 地址和认证填入你客户端的 MCP / Tools / Connectors 设置，通用示例如下：

{ "mcpServers": { "agentdock": { "url": "http://127.0.0.1:8765/mcp", "headers": { "Authorization": "Bearer <AGENTDOCK_AUTH_TOKEN>" } } } }

✅ 验证安装是否成功

完成安装与接入后，按这两层快速确认：

记住两个默认运行目录，方便日后排查：

• ~/AgentDock：相对文件操作的默认工作目录
• ~/.agentdock：状态、配置、会话与扩展数据

📚 小结与延伸阅读

• 5 分钟路径：装好官方包 → 拿到 MCP 地址与 Token → 填入客户端 →curl /healthz验证。
• 端口默认8765，可通过配置调整，客户端以实际部署为准。
• 完整配置速查：core-skills/agentdock-user-guide/references/configuration.md
• 用户指南 Skill 入口：core-skills/agentdock-user-guide/SKILL.md

把 AI 的双手真正触达你的每一台设备——装好 AgentDock，剩下的交给一次对话。🚀