mosdns/BUILD-USAGE.md

🔨 构建脚本使用说明

问题修复

❌ 错误的运行方式

sh build-all-platforms.sh  # 会报错！

错误信息：

Syntax error: "(" unexpected (expecting "then")

✅ 正确的运行方式

# 方式1: 使用 bash（推荐）
bash build-all-platforms.sh

# 方式2: 直接执行
chmod +x build-all-platforms.sh
./build-all-platforms.sh

---

交互式编译

运行脚本后会看到菜单：

╔════════════════════════════════════════════╗
║   MosDNS 多平台构建工具 (带 Web UI)       ║
╚════════════════════════════════════════════╝

请选择要编译的平台：

  [1] Linux AMD64            (x86_64 服务器)
  [2] Linux ARM64            (树莓派、ARM 服务器)
  [3] Windows AMD64          (Windows 64位)
  [4] macOS AMD64            (Intel Mac)
  [5] macOS ARM64            (Apple Silicon M1/M2/M3)

  [6] 编译所有 Linux 版本    (AMD64 + ARM64)
  [7] 编译所有 macOS 版本    (AMD64 + ARM64)
  [8] 编译所有 Windows 版本  (仅 AMD64)

  [A] 编译全部平台           (推荐用于发布)

  [0] 退出

选择示例：

• 输入 1 - 只编译 Linux AMD64
• 输入 A - 编译所有平台
• 输入 6 - 编译所有 Linux 版本

---

非交互式编译

单个平台

# Linux AMD64
bash build-all-platforms.sh <<< "1"

# Windows AMD64  
bash build-all-platforms.sh <<< "3"

# macOS ARM64 (Apple Silicon)
bash build-all-platforms.sh <<< "5"

批量编译

# 所有 Linux 版本
bash build-all-platforms.sh <<< "6"

# 所有平台
bash build-all-platforms.sh <<< "A"

---

直接使用 go build

当前平台

go build -o dist/mosdns-linux-amd64 .

指定平台

# Linux AMD64
GOOS=linux GOARCH=amd64 go build -o dist/mosdns-linux-amd64 .

# Linux ARM64
GOOS=linux GOARCH=arm64 go build -o dist/mosdns-linux-arm64 .

# Windows AMD64
GOOS=windows GOARCH=amd64 go build -o dist/mosdns-windows-amd64.exe .

# macOS AMD64 (Intel)
GOOS=darwin GOARCH=amd64 go build -o dist/mosdns-darwin-amd64 .

# macOS ARM64 (Apple Silicon)
GOOS=darwin GOARCH=arm64 go build -o dist/mosdns-darwin-arm64 .

---

前端构建

自动构建

脚本会自动检查并构建 Vue 前端（如果需要）

手动构建

cd web-ui
npm install
npm run build
cd ..

---

输出文件

编译产物在 dist/ 目录：

dist/
├── mosdns-linux-amd64          # Linux x86_64
├── mosdns-linux-arm64          # Linux ARM64
├── mosdns-windows-amd64.exe    # Windows 64位
├── mosdns-darwin-amd64         # macOS Intel
└── mosdns-darwin-arm64         # macOS Apple Silicon

---

常见问题

Q: 为什么 sh build-all-platforms.sh 会报错？

A: 脚本使用了 Bash 特性，必须用 bash 运行。

Q: 如何跳过前端构建？

A: 确保 web-ui/dist/index.html 已存在，脚本会自动跳过。

Q: 编译失败怎么办？

A: 检查：

1. Go 版本 >= 1.20
2. Node.js 和 npm 已安装（如需构建前端）
3. 网络连接正常（下载依赖）

Q: 如何编译特定平台？

A: 运行脚本后选择对应编号，或使用 go build 直接编译。

---

快速命令

# 开发：编译当前平台
go build -o dist/mosdns .

# 测试：编译 Linux AMD64
bash build-all-platforms.sh <<< "1"

# 发布：编译所有平台
bash build-all-platforms.sh <<< "A"

---

💡 提示： 首次编译会下载依赖和构建前端，需要几分钟时间。后续编译会快很多。