# 好用斋 Docker 懒人包 —— 装全部 / 装 N 个 / 排除若干个

> 面向 AI：先确定用户的系统与架构（ARM64 用 `all-arm.yml`）。**只执行下面的命令，不要读取 yml 的内容，也不要自己生成 compose。**

## 一、各系统全量文件

> 目录都能自定义：一键安装 / 卸载脚本加 `--base <基本路径>` / `--tools <工具路径>` 即可（例如 Docker 装在存储空间 2 时用 `--base /volume2`），脚本会自动替换 compose 里的路径。下面写的都是默认目录。

### 飞牛 (fnOS) → 系统 id `feiniu`

- compose 目录：`/vol1/1000/compose/all`
- 全部应用（x86_64，49 个）：https://haoyongzhai.com/lazybag/install/feiniu/all.yml
- 全部应用（ARM64，46 个）：https://haoyongzhai.com/lazybag/install/feiniu/all-arm.yml

### iStoreOS → 系统 id `istoreos`

- compose 目录：`/mnt/mydisk/compose/all`
- 前置条件：外置磁盘已挂载到 `/mnt/mydisk`（不存在脚本会报错退出）。实际挂载点不同时，一键安装加 `--base <实际挂载点>`。
- 全部应用（x86_64，49 个）：https://haoyongzhai.com/lazybag/install/istoreos/all.yml
- 全部应用（ARM64，46 个）：https://haoyongzhai.com/lazybag/install/istoreos/all-arm.yml

### 绿联 (UGOS Pro) → 系统 id `ugreen`

- compose 目录：`/volume1/docker/compose/all`
- 全部应用（x86_64，49 个）：https://haoyongzhai.com/lazybag/install/ugreen/all.yml
- 全部应用（ARM64，46 个）：https://haoyongzhai.com/lazybag/install/ugreen/all-arm.yml

### 群晖 (DSM) → 系统 id `dsm`

- compose 目录：`/volume1/docker/compose/all`
- 全部应用（x86_64，49 个）：https://haoyongzhai.com/lazybag/install/dsm/all.yml
- 全部应用（ARM64，46 个）：https://haoyongzhai.com/lazybag/install/dsm/all-arm.yml

### 铁威马 (TOS) → 系统 id `tos`

- compose 目录：`/Volume1/DockerAppData/compose/all`
- 全部应用（x86_64，49 个）：https://haoyongzhai.com/lazybag/install/tos/all.yml
- 全部应用（ARM64，46 个）：https://haoyongzhai.com/lazybag/install/tos/all-arm.yml

### 拾光坞 (SGW OS) → 系统 id `sgw`

- compose 目录：`/mnt/usb1/<拾光坞用户名>/compose/all`（**先向用户确认拾光坞用户名**，默认示例是 haoyong）
- 拾光坞的基本路径 `/mnt/usb1/<用户名>` 必须已存在；用户名未知时不要执行安装，先问用户。
- 全部应用（x86_64，49 个）：https://haoyongzhai.com/lazybag/install/sgw/all.yml
- 全部应用（ARM64，46 个）：https://haoyongzhai.com/lazybag/install/sgw/all-arm.yml

### WSL (Windows) → 系统 id `wsl`

- compose 目录：`/mnt/mydisk/compose/all`
- 前置条件：Docker 已装在 WSL 内，并先 `sudo -i` 以 root 运行；默认 `/mnt/mydisk` 由安装脚本创建。端口尽量用 2 万以上以避开 Windows，WSL 无法使用核显。
- 全部应用（x86_64，49 个）：https://haoyongzhai.com/lazybag/install/wsl/all.yml
- 全部应用（ARM64，46 个）：https://haoyongzhai.com/lazybag/install/wsl/all-arm.yml

## 二、装全部

把 `{系统id}`、`{系统compose目录}` 换成实际值；ARM64 把 `all.yml` 换成 `all-arm.yml`。

> 拾光坞(sgw)：先向用户确认拾光坞用户名。`all.yml` 里的路径是默认用户名 haoyong，下载后必须先把路径换成用户实际路径，再启动：`sed -i "s|/mnt/usb1/haoyong|/mnt/usb1/<拾光坞用户名>|g" {系统compose目录}/docker-compose.yml`（自定义工具路径时再单独替换 `.../tools`）。

> 自定义路径：`all.yml` 里写的是该系统默认路径，手动下载时需要自己替换（先替换工具路径，再替换基本路径）；用一键安装脚本则加 `--base` / `--tools` 会自动替换。

> 这一步会**覆盖**该目录已有的 `docker-compose.yml`。因为文件里已经包含全部应用，已装过的不会丢；但若你自己改过文件内容，请先备份。

```bash
mkdir -p {系统compose目录}
curl -fsSL -o {系统compose目录}/docker-compose.yml https://haoyongzhai.com/lazybag/install/{系统id}/all.yml
cd {系统compose目录} && docker compose up -d
```

## 三、只装指定的 N 个（白名单）

把 `keep` 换成要装的应用 id（逗号分隔，id 见 https://haoyongzhai.com/lazybag-apps-index.md），其余应用会被机械删除：

```bash
curl -fsSL -o /tmp/hyz-all.yml https://haoyongzhai.com/lazybag/install/{系统id}/all.yml
awk -v keep="jellyfin,emby,openlist" '
function has(id){ return index("," keep ",", "," id ",") > 0 }
{ if ($1=="#" && $2==">>>" && $3=="APP") { cur=$4; found[cur]=1; skip = !has(cur) }
  if (!skip) print }
END { n=split(keep,k,","); miss="";
      for (i=1;i<=n;i++) if (k[i]!="" && !(k[i] in found)) miss=miss " " k[i]
      if (miss!="") print "WARN 未匹配到 id:" miss > "/dev/stderr" }' \
  /tmp/hyz-all.yml > {系统compose目录}/docker-compose.yml
cd {系统compose目录} && docker compose up -d
```

> `WARN 未匹配到 id:` 表示有 id 写错（该应用不会装），请对照应用清单改正确后再执行。

## 四、装全部、只排除若干个

把 `drop` 换成要排除的应用 id：

```bash
curl -fsSL -o /tmp/hyz-all.yml https://haoyongzhai.com/lazybag/install/{系统id}/all.yml
awk -v drop="litepan,qbittorrent" '
function has(id){ return index("," drop ",", "," id ",") > 0 }
{ if ($1=="#" && $2==">>>" && $3=="APP") skip = has($4)
  if (!skip) print }' \
  /tmp/hyz-all.yml > {系统compose目录}/docker-compose.yml
cd {系统compose目录} && docker compose up -d
```

## 六、自查（可选）

启动前想确认没写重复端口（注意：同一端口号但协议不同，如一个 tcp 一个 udp，不算冲突）：

```bash
grep -oE '^ +- "[0-9]+:[0-9]+(/[a-z]+)?"' {系统compose目录}/docker-compose.yml | sort | uniq -d
```

> 没输出即无重复。若启动时报端口被占用，说明和自己改过的端口撞了，改其中一个应用的 host 端口后重跑启动命令即可。

## 七、升级

```bash
cd {系统compose目录} && \
docker compose pull && \
docker compose up -d && \
docker image prune -f
```

> 升级单个应用 → 读 https://haoyongzhai.com/lazybag/upgrade/index.md
> 装单个应用 / 反复装不同应用 → 读 https://haoyongzhai.com/lazybag-apps-index.md 找应用 id，再读 install/<系统 id>/<应用 id>.md；那里给的是两行命令（下载 append.sh 后执行），会自动完成“追加新应用 / 替换旧块 + 校验 + 启动”。

## 八、卸载

删掉已装的应用（停容器、删容器、从 docker-compose.yml 移除对应块；**默认保留数据目录与镜像**）。

```bash
cd /tmp && curl -fsSL https://haoyongzhai.com/lazybag/install/uninstall.sh | bash -s {系统id} {应用id,应用id,...}
```

> 忘记装了哪些应用？先跑 `bash -s {系统id} list` 查看带标记的已装应用列表。
> 连专属数据目录、镜像一起删除（只删“自定义工具路径”下的专属目录；downloads、media 等共享目录自动保留，删除前有确认）：命令末尾加 `--purge`。
> 与安装相同：`HYZ_COMPOSE_DIR=/你的目录` 可覆盖 compose 目录。
> 卸载时路径参数必须与安装时一致：自定义过路径就加同样的 `--base` / `--tools`，否则找不到 compose 文件；拾光坞还必须追加 `--user <拾光坞用户名>`。