# agserver.svc

> [!important]
> 现在我的 Docker 服务均作了去敏处理：强依赖本机系统环境的配置均改用下表列示的环境变量传参。
>
> 你需要在`docker-compose.yml`所在文件夹里另行创建`.env`文件，填充需要的环境变量。  
> 另注：**终端环境变量的优先级要高于`.env`**，修改 compose 配置时还请谨慎添加变量。
>
> 当然直接编辑 compose 配置也无何不可，万一不满意别的配置呢？

| 服务 | 是否容器化 | 环境变量 | 默认值 |
|------|------------|----------|------|
| cockpit dashboard | ❌ | - | - |
| nginx             | ❌ | - | - |
| mihomo    | ✅ | PWD | 当前终端的 $PWD |
| jellyfin  | ✅ | MEDIA_PATH | /media |
| aria2 | ✅ | PUID, PGID | 1000 |
|       |   | ARIA2_RPC_SECRET | P3TERX |
|       |   | ARIA2_RPC_PORT | 6800 |
|       |   | ARIA2_BT_PORT | 6888 |
|       |   | ARIANG_PORT   | 6880 |
|       |   | CONF_PATH, DOWNLOAD_PATH |
| filebrowser | ✅ | FB_PORT | 8080 |
|           |   | PUID, PGID, SRV_PATH |
| navidrome | ✅ | MUSIC_PATH, PUID, PGID |
| pigallery2 | ✅ | PIG_PORT | 80 |
|           |   | IMG_DIR |

## 备注

### cockpit
- 新版 Ubuntu 的 sudo 命令行不完全，暂时需回退为`sudo.ws`
- 需要用`nmcli`另建一空网口以便正常检查软件包更新
- chrony 需要换用国内 NTP 服务器

### jellyfin
1. 部署流程参见[这篇知乎专栏](https://zhuanlan.zhihu.com/p/624670198)。
    - nyanmisaka 版（即本仓库用的镜像）可以省略“在容器里安装英特耳显卡驱动”的步骤。
    - 我曾遇到过容器缺失 render 组导致 QSV 硬解调用 renderD128 时出现问题。
    在 GitHub 相关问题帖中，有人只挂载`/dev/dri/renderD128`并反馈可用。于是我也干了。
    - 你在管理面板里能选的硬解格式很大程度上取决于 vainfo 命令的输出，并非像很多教程里说的“尽量都选上”。
    无论如何，进容器里检查一下总归不碍事。

2. 如需使用硬件加速功能，切记**不许非 root 运行**！

### aria2
- 容器会自动下载 [P3TERX/aria2.conf](https://github.com/P3TERX/aria2.conf) 配置到 CONF_PATH。
- DOWNLOAD_PATH 是什么样，下载的位置就是什么样。
- 防火墙务必提前放行 aria2 监听端口（至少放`$ARIA2_BT_PORT/tcp,udp`）
- P3TERX 默认禁用 IPv6。经多方测试，咱家也的确没有 IPv6。在现有条件（无 IPv6 无公网）下最优解就是保留现状。

### filebrowser
事实上我更推荐 FileStash。只是 Office 组件调教起来比较麻烦。我没得出比较便捷的方案，就先用这个备选了。

### navidrome
- `ND_`开头的环境变量配置可参见[在线文档](https://www.navidrome.org/docs/usage/configuration/options/#environment-variables)。
- 我最终选择把音乐库暴露给公网，因此配置单也加了很多限制措施，仅供参考。