calagopus/wings

Docker Wings安装

Docker镜像变体

安装Docker

是否使用Podman替代？
Podman可作为Docker的替代方案。若偏好Podman，请通过二进制文件或包管理器安装Wings，并遵循使用Podman运行Wings指南。Docker Compose方法需依赖Docker。

验证Docker安装：

bash
docker --version
docker compose version # 若提示"command not found"，可尝试使用`docker-compose`或更新Docker

未安装Docker时，可通过官方脚本快速安装：

bash
curl -sSL https://get.docker.com/ | CHANNEL=stable bash

该脚本会同时安装Docker Compose，若未成功请参考https://docs.docker.com/compose/install%E6%88%96https://docs.docker.com/engine/install%E3%80%82

下载Compose栈

bash
mkdir calagopus-wings
cd calagopus-wings

curl -o compose.yml https://raw.githubusercontent.com/calagopus/wings/refs/heads/main/compose.local.yml
ls -lh # 确认compose.yml文件存在

更改镜像变体（可选）

默认使用:latest变体，如需切换，修改compose.yml中wings服务的镜像标签即可。示例：通过sed切换到:nightly

bash
sed -i -e "s/calagopus\/wings:latest/calagopus\/wings:nightly/g" compose.yml

配置Wings

启动前需在面板注册节点并获取配置：

1. 遵循添加节点指南创建节点
2. 从面板节点配置页复制配置内容

创建配置目录及文件：

bash
mkdir config
nano config/config.yml

粘贴配置内容并保存。

警告：卷路径必须完全匹配
若修改卷位置，compose.yml与config/config.yml中的路径需完全一致且为绝对路径，否则会导致服务器容器创建失败。

启动Wings

bash
docker compose up -d

该命令拉取镜像并以后台模式启动Wings，面板应显示节点已连接。若遇问题，查看日志：

bash
docker compose logs -f wings

下一步

Wings运行后，需设置服务器可分配的IP和端口组合，详情见设置分配。