EasyTier Docker Image (Auto-Build)

这是一个基于 GitHub Actions 自动构建的 EasyTier Docker 镜像仓库。 它可以让你在不安装 Rust 编译环境的情况下，快速获得最新版本的 EasyTier Docker 镜像，并支持在 Docker 环境（如 1Panel、群晖、Linux 服务器）中一键部署。

✨ 特性

• 自动构建：基于 EasyTier 官方 Release 版本自动打包。
• 轻量级：使用 debian-slim 作为基础镜像，体积小巧。
• 开箱即用：预装 iptables 等必要依赖，支持 VPN 组网。

🚀 快速开始

方式一：Docker CLI (命令行)

如果你熟悉命令行，可以直接运行以下命令：

# 请将 <你的用户名> 和 <你的仓库名> 替换为实际内容
# 请修改 --ipv4 和 --network-secret 为你自己的配置

docker run -d \
  --name easytier \
  --network host \
  --cap-add NET_ADMIN \
  --device /dev/net/tun \
  --restart always \
  ghcr.io/<你的用户名>/<你的仓库名>:latest \
  --ipv4 10.144.144.1 \
  --network-name "MyPrivateNet" \
  --network-secret "MyPassword123"

方式二：Docker Compose

创建 docker-compose.yml 文件：

version: "3"
services:
  easytier:
    image: ghcr.io/<你的用户名>/<你的仓库名>:latest
    container_name: easytier
    network_mode: host
    cap_add:
      - NET_ADMIN
    devices:
      - /dev/net/tun
    restart: always
    command: --ipv4 10.144.144.1 --network-name "MyPrivateNet" --network-secret "MyPassword123"

---

🖥️ 1Panel 部署指南 (推荐)

如果你使用 1Panel 面板，请按照以下步骤操作：

1. 拉取镜像

• 进入 1Panel 「容器」 -> 「镜像」。
• 点击 「拉取镜像」。
• 镜像来源选择 直接拉取，输入：ghcr.io/<你的用户名>/<你的仓库名>:latest。

2. 创建容器 (关键配置)

点击 「创建容器」，并确保按照下表配置：

配置项	填写内容 / 操作	说明
名称	easytier	随意填写
网络	host	⚠️ 必须选择 host 模式，否则性能受限
运行命令	--ipv4 10.144.144.1 --network-name "MyPrivateNet" --network-secret "MyPassword123"	这里填写启动参数
特权模式	勾选 ✅	⚠️ 在「高级设置」或「更多设置」中，必须勾选，否则无法创建网卡
重启策略	总是 (Always)	保证服务器重启后自动连接

---

⚙️ 参数说明

参数	示例	必填	说明
--ipv4	10.144.144.1	✅	设置该节点在虚拟网络中的 IP 地址
--network-secret	123456	✅	组网密码，所有节点必须一致
--network-name	MyNet	❌	网络名称，默认为 default，建议修改以隔离网络
--peers	tcp://1.2.3.4:11010	❌	如果你是作为客户端连接其他公网节点，需填写此项

---

🛠️ 如何自行构建

本项目配置了 GitHub Actions，当你执行以下操作时会自动触发构建：

1. 修改 Dockerfile 文件。
2. 推送代码到 main 分支。

构建完成后，镜像会自动发布到本仓库的 GitHub Packages (GHCR) 中。