脚本库¶
本页集中维护 AgentMeshOS 当前可直接下载和执行的脚本。脚本会随文档站 Docker 镜像一起发布，访问域名为 https://docs.yohan.fun。
使用规则¶
- 脚本必须来自本仓库，不从第三方临时地址下载。
- 每个正式发布脚本必须有脚本名、归属项目、版本号和更新日期。
- 新增或更新脚本后，需要同步更新本页的项目归属、更新日期和下载链接。
- Linux 脚本默认通过
sudo bash执行；执行前应先阅读脚本用途和适用范围。 - 文档站容器只负责发布脚本文件，不负责保存密钥、Token 或任何私密配置。
可下载脚本¶
| 文件 | 对应项目 | 版本 | 更新日期 | 下载链接 | 推荐命令 |
|---|---|---|---|---|---|
agentmeshos-docs-docker-deploy.sh |
文档站 Docker 部署 | v0.1.2 |
2026-07-04 | 下载 | curl -fsSL https://docs.yohan.fun/scripts/agentmeshos-docs-docker-deploy.sh \| sudo bash |
tailscale-headscale-linux.sh |
Linux Worker 接入 Headscale | v0.2.0 |
2026-07-04 | 下载 | curl -fsSL https://docs.yohan.fun/scripts/tailscale-headscale-linux.sh \| sudo bash |
当前脚本说明¶
文档站 Docker 部署脚本¶
用于在主节点部署或更新文档站容器。脚本会拉取 GitHub Actions 构建出的镜像，并将容器固定监听到 127.0.0.1:39130，再由宝塔 Nginx 反代到 https://docs.yohan.fun。
本机仓库执行方式：
Linux Worker 接入脚本¶
用于新 Linux Worker 节点安装 Tailscale 客户端，并通过自托管 Headscale 控制面接入 https://mesh.yohan.fun。脚本包含中文菜单，可处理安装、重装、更换接入 Key、手动注册生成 Machine Key / 注册链接、查看状态、断开、清空状态和卸载等操作。
本机仓库执行方式：
后续维护方式¶
后续新增小项目脚本时，优先按项目归类放入 scripts/deploy/<project-name>/ 或 scripts/clients/，并在文档站 Dockerfile 中发布到 /scripts/ 下载目录。本页同步补充脚本名称、项目归属、版本号、更新日期和下载链接，保证脚本库是可下载的文件库，而不是只写说明的文本页。
脚本版本号必须随脚本功能变化同步调整：
- 只修正文案、注释或提示信息：递增补丁版本，例如
v0.1.1到v0.1.2。 - 新增菜单项、参数、部署能力或兼容范围：递增次版本，例如
v0.1.1到v0.2.0。 - 改变默认端口、默认域名、清理逻辑、删除逻辑或其他可能影响现有机器的行为：递增主版本，例如
v0.1.1到v1.0.0，并在执行前明确提示风险。
自动同步说明¶
脚本库不需要手工单独同步。只要修改 scripts/clients/**、scripts/deploy/docs-site/**、docs/** 或 tools/docs-site/** 并推送到 GitHub，文档站 GitHub Actions 会自动重新构建镜像。Dockerfile 会把仓库里的脚本源文件复制到站点 /scripts/ 下载目录，因此线上脚本与仓库脚本保持一致。