极空间Docker总崩?90%的人栽在权限设置!ARM用户避坑指南+保姆级部署清单
超过六成的Docker部署失败,根源并非镜像拉取或网络配置,而是挂载目录权限未在容器启动前正确设置。极空间用户尤其容易忽略这一点——系统默认创建的共享文件夹对Docker容器并无写入权限,导致服务看似正常启动,实则日志无法写入、数据库无法初始化,最终静默崩溃。

一、环境确认
1、确认设备兼容性
2、检查存储与权限配置
容器数据持久化依赖主机路径挂载,而极空间要求该路径必须是已存在的共享文件夹,并显式赋予“最大读写权限”。操作路径为:【存储管理】→【共享文件夹】→新建或选择现有文件夹→点击【权限设置】→勾选【合规目录最大读写权限】。若跳过此步,容器内进程因权限不足无法写入文件,表现为服务反复重启或功能异常。特别注意:不要直接挂载根目录(如/share),应创建专用子目录(如/share/ContainerData)并单独授权。27

二、安装准备
1、启用Docker服务
在ZOS 2.x系统中,Docker功能以独立应用形式存在。进入【应用中心】→搜索“Docker”→点击安装。首次启用会自动初始化存储位置,默认指向/share/ContainerData。此步骤不可跳过,否则后续容器创建时将无法选择挂载点。安装完成后,主界面出现“Docker”图标,点击即可进入容器管理面板。28
2、配置网络与端口
极空间Docker采用桥接网络模式,容器端口需映射至主机端口。为避免冲突,建议提前规划常用服务端口范围。若多个容器绑定同一主机端口,后启动者将失败。UPnP若开启,可能自动转发端口,但家庭网络环境下建议手动配置更稳定。
| 服务类型 | 推荐端口范围 |
|---|---|
| Web服务(如Jellyfin、Home Assistant) | 8080-8099 |
| 数据库(如MySQL、PostgreSQL) | 3306-3310, 5432-5435 |
| 下载工具(如qBittorrent) | 8081-8085, 6881-6899(BT端口) |
| AI服务(如Ollama、OpenClaw) | 11434-11440 |
极空间Docker常用服务端口规划建议

三、镜像与容器部署
1、选择合适镜像源
拉取镜像前务必确认架构匹配。在Docker Hub页面查看镜像支持的平台(Platforms),ARM设备用户应选择linux/arm64或linux/arm/v7标签。国内用户可配置镜像加速器提升下载速度:进入Docker设置→【镜像加速】→添加阿里云或中科大加速地址。切勿盲目使用latest标签,应指定明确版本号(如jellyfin/jellyfin:10.9.7)以避免兼容性问题。14
2、创建容器关键参数设置

四、性能与稳定性优化
1、资源限制与调度
2、日志与监控配置
极空间Docker日志默认存储于容器内部,长期运行可能占满系统盘。应在创建容器时将日志目录挂载至主机路径(如./logs:/app/logs),便于定期清理。原生日志查看入口位于容器详情页的【日志】标签,支持按时间筛选。目前不支持集成Prometheus等第三方监控,依赖手动检查日志内容排查异常。

五、维护与更新
1、容器备份与迁移
备份核心是保存两部分:一是数据卷(如数据库文件、媒体库),二是配置文件(docker-compose.yml及.env)。极空间将Compose项目文件自动保存至所选存储位置的根目录,因此只需备份整个项目文件夹(如/share/ContainerData/my-jellyfin-stack)即可。换机时,复制该文件夹到新设备同路径,重新创建项目并指向该目录,容器配置与数据将完整恢复。28
2、镜像与服务更新策略
更新流程必须严格遵循:先备份项目文件夹 → 在Docker界面停止并删除旧容器(保留卷)→ 手动拉取新镜像 → 使用原配置重新创建容器。切勿直接覆盖运行中容器,否则可能导致数据损坏。若新版本不兼容,可回滚至上一版镜像标签重建容器。极空间暂不支持一键更新,需手动操作。

六、常见问题与避坑指南
做好这三点,你的极空间Docker才能真正稳定跑起来:部署前确认架构与权限,运行中限制资源防卡死,更新时先备份再操作。别被“一键部署”的宣传迷惑,家庭NAS的Docker体验,终究建立在对细节的掌控之上。
当前文章无评论,是时候发表评论了