Release 下载mack-a 八合一脚本 · GitHub Release 历史版本 · 三路反代镜像
最新正式版v3.5.19本区块同步 mack-a 八合一脚本 的官方 GitHub Release，并为最近版本生成 三路反代镜像加速下载通道。 默认展开最新正式版；如果项目只有预发布版，会在版本旁单独标注。下载按钮会先进入本站确认页，可继续下载或复制真实链接。
mack-a v2ray-agent 由 mack-a 维护，是中文社区常见的多协议一键脚本。它的价值不是“无脑安装”，而是把 Xray、sing-box、证书申请、用户管理和订阅导出集中到一个菜单里，适合已经能独立维护 VPS 的用户。
mack-a 适合谁，不适合谁？
| 你的情况 | 建议 | 原因 |
|---|---|---|
| 已有 Linux VPS 和域名 | 可以用 mack-a | 脚本需要域名解析、证书和端口配合 |
| 想在一台机器上试多协议 | 可以用 mack-a | Xray 与 sing-box 组合更方便切换 |
| 只想快速生成一个单协议配置 | 看 233boy sing-box | 流程更短，菜单更轻 |
| 不会 SSH、不会看防火墙 | 不建议直接上手 | 证书失败、端口占用时很难判断原因 |
| 已经有生产服务跑在 80/443 | 评估端口冲突 | nginx、Apache、面板都可能抢端口 |
一句话：mack-a 是“脚本化运维工具”，不是桌面客户端。它能省掉大量手工配置，但前提是你知道脚本在改哪台服务器。
安装前先检查哪 4 件事？
把下面 4 项过一遍，再运行脚本。很多安装失败不是脚本本身坏了，而是 VPS 环境没准备好。
| 检查项 | 怎么确认 | 卡住时的典型表现 |
|---|---|---|
| 系统版本 | cat /etc/os-release | 依赖安装失败、菜单异常退出 |
| 域名解析 | 域名 A 记录指向 VPS IP | 证书申请失败、客户端连不上 |
| 80/443 端口 | 云防火墙和系统防火墙都放行 | ACME 校验失败、HTTPS 无响应 |
| 旧配置备份 | 备份 /etc/v2ray-agent 或相关目录 | 升级后无法回滚 |
如果 VPS 已经装过 nginx、Apache、宝塔、1Panel 或其他代理面板，确认 80 和 443 是否被占用。不要在生产机器上边猜边跑脚本，做快照更稳。
一键命令怎么跑？
官方仓库给出的入口是从 GitHub raw 拉取 install.sh，再给脚本执行权限。
wget -P /root -N --no-check-certificate "https://raw.githubusercontent.com/mack-a/v2ray-agent/master/install.sh" && chmod 700 /root/install.sh && /root/install.sh如果 GitHub raw 访问很慢，不要把镜像地址直接塞进 bash，在浏览器或服务器上下载脚本，确认来源和内容后再运行。
wget -P /root -N "https://raw.githubusercontent.com/mack-a/v2ray-agent/master/install.sh"
chmod 700 /root/install.sh
/root/install.sh最低准备项建议按这个范围看：Debian 10+、Ubuntu 20.04+ 或 CentOS 7+；一个已经解析到 VPS 的域名；80 和 443 端口开放；能用 root 或 sudo 权限执行安装。
第一次安装会遇到哪些菜单？
脚本启动后主要是菜单驱动，常用入口大致是安装、添加用户、修改伪装站、切换或添加协议、切换内核、查看节点信息和卸载。
+-----------------------+
| 1. 安装 |
| 2. 添加用户 |
| 3. 修改伪装站 |
| 4. 切换 / 添加协议 |
| 5. 切换 内核 |
| 6. 查看节点信息 |
| 7. 卸载 |
+-----------------------+第一次安装通常按这个顺序走：选“安装”，输入域名，选择协议组合，申请 SSL 证书，最后查看节点信息和订阅地址。不要一开始就全协议全选，跑通 1-2 个你真的会用的协议更容易排错。
添加用户时，脚本会生成单独的 token 或订阅信息。给家人、朋友或测试设备分开 token，比所有设备共用一个配置更好管理。
切换内核时先看协议需求：Reality、Vision 这类配置通常走 Xray-core；Hysteria 2、TUIC、Naive 这类配置更常见于 sing-box。切换前先备份，避免新旧配置互相覆盖。
哪些协议值得先开？
不要把协议列表当成越多越好。协议开得越多，端口、证书、客户端兼容性和排错面也越多。
| 协议 | 常见端口 | 用场景 | 注意点 |
|---|---|---|---|
| VLESS Reality | 443 | 默认优先测试 | SNI、dest、客户端版本要匹配 |
| VLESS Vision XHTTP | 443 | 想测试新传输层 | 客户端支持度要确认 |
| VMess WS + TLS | 443 | 需要 WebSocket 兼容 | 配置项多，别和旧 VMess 混淆 |
| Trojan | 443 | 传统 TLS 入口 | 证书和域名必须稳定 |
| Hysteria 2 | UDP 443 或自定义 | 高丢包链路测试 | 云厂商 UDP 策略差异较大 |
| TUIC v5 | UDP 443 | 低延迟链路测试 | 客户端版本不一致时容易失败 |
| Shadowsocks 2022 | 自定义 | 轻量备用 | 客户端需支持 2022 加密 |
| NaiveProxy | 443 | 特定客户端需求 | 配置和客户端选择更挑剔 |
建议第一轮只选一个 TCP/TLS 类协议和一个 UDP 类协议。两个都跑通后，再决定要不要扩到更多组合。
客户端怎么导入订阅？
脚本安装完成后，在菜单里查看节点信息，通常会给出类似 https://your-vps:port/token 的订阅 URL。不要把它发到公开聊天或截图里，token 泄露后别人可能直接导入使用。
常见导入路径如下：
| 客户端 | 更适合的格式 | 导入位置 |
|---|---|---|
| Clash Verge Rev | Clash / Mihomo | 配置或订阅入口 |
| Mihomo Party | Clash / Mihomo | 订阅管理 |
| v2rayN | V2Ray / Xray | 服务器订阅 |
| v2rayNG | V2Ray / Xray | 订阅设置 |
| Karing | sing-box | 配置导入 |
| Hiddify Next | sing-box / 通用链接 | 新增配置 |
| Shadowrocket | 通用订阅 | 远程文件 |
| Stash | Clash | 配置文件 |
导入后先手动刷新一次，再看节点列表是否出现。节点存在不等于可用，还要分别测试 TCP 类和 UDP 类协议。
证书、端口、订阅常见问题怎么排？
| 现象 | 更可能原因 | 做什么 |
|---|---|---|
| 证书申请失败 | 80 端口被占、DNS 未生效、云防火墙拦截 | 暂停 nginx/Apache，检查 A 记录和安全组 |
| 节点列表为空 | 订阅 URL 填错、token 复制不完整、格式不兼容 | 浏览器打开订阅地址，看返回内容 |
| 客户端显示超时 | 443 未放行、SNI/dest 错、客户端协议不支持 | 用同一协议换另一个客户端验证 |
| UDP 协议不可用 | 云厂商限制 UDP、系统防火墙未放行 | 测试 TCP 协议，再单独排 UDP |
| 流量统计不准 | Xray API 统计重启后变化 | 不把脚本统计当长期账本 |
证书问题优先看端口和解析，不要一上来重装脚本。订阅问题优先看返回内容，很多“导入失败”其实是拿到了错误页、空文件或旧缓存。
自建还是用现成订阅？
自建适合学习和小范围自用：你能控制 VPS、协议、日志和升级节奏，也能随时删掉重来。代价是证书、端口、系统更新、滥用风险和故障排查都要自己负责。
现成订阅适合多人、多地区、多设备并行使用。尤其是桌面端、手机端、软路由同时在线时，自己维护一台 VPS 很快会遇到带宽、地区和故障响应问题。
如果你已经用 mack-a 跑通了自建入口，但还需要给 Clash、sing-box、V2Ray 客户端准备日常主力配置，可以把自建当备用，把兼容 Clash / Singbox / V2Ray 的订阅用于多设备同步和日常切换。
| 场景 | 更合适的选择 |
|---|---|
| 1-2 个固定自用入口 | 自建 mack-a |
| 学习 Xray / sing-box 配置 | 自建 mack-a |
| 多人、多设备、多地区 | 现成订阅 |
| 不想处理证书和端口 | 现成订阅 |
| 已有主力订阅，想要备用入口 | 自建 mack-a |
升级和卸载前要注意什么？
升级前先做 VPS 快照，再备份脚本配置目录和证书相关目录。不要在你最需要使用的时段升级，失败后回滚会很被动。
卸载前确认两件事：第一，是否还有客户端在用这台 VPS 的订阅；第二，是否有其他服务复用了同一个域名或 443 端口。脚本卸载后，客户端配置不会自动删除，旧订阅还会留在本地。
如果你打算从 mack-a 迁到面板类工具，可以先对比 Marzban 和 3X-UI。前者更像用户和订阅管理面板，后者更偏 Xray 图形化配置。