1. 项目概述NAS与Docker的黄金组合2026年的家庭数字生活已经离不开NAS网络附加存储设备而Docker容器技术让NAS的功能边界得到了革命性扩展。飞牛NAS作为国产设备中的佼佼者其fnOS系统对Docker的支持尤为出色。这个组合能实现家庭媒体中心电影/音乐/照片管理自动化工具下载/备份/同步智能家居中枢开发测试环境私有云服务实测在飞牛NAS上运行Docker容器资源占用比传统虚拟机低60%部署速度提升5倍以上。对于新手而言最大的障碍往往不是技术本身而是缺乏系统化的指导——这正是本指南要解决的问题。2. 飞牛NAS的Docker环境准备2.1 硬件需求检查在飞牛NAS上运行Docker前建议确认设备配置内存至少4GB推荐8GB存储系统盘剩余空间10GBCPUx86架构J4125/N5105等或ARMv8RK3568等提示通过飞牛OS的「系统监控」可查看实时资源占用建议在CPU负载50%时进行安装2.2 Docker引擎安装飞牛OS应用中心提供两种安装方式图形化安装推荐新手进入「应用中心」搜索Docker点击安装后自动完成内核模块加载和网络配置SSH手动安装高级用户# 添加官方仓库 echo deb [arch$(dpkg --print-architecture)] https://download.docker.com/linux/debian $(lsb_release -cs) stable | sudo tee /etc/apt/sources.list.d/docker.list /dev/null # 安装依赖 sudo apt-get update sudo apt-get install -y docker-ce docker-ce-cli containerd.io # 验证安装 sudo docker run hello-world2.3 关键配置优化编辑/etc/docker/daemon.json不存在则新建{ registry-mirrors: [https://docker.mirrors.ustc.edu.cn], log-driver: json-file, log-opts: { max-size: 10m, max-file: 3 }, data-root: /volume1/docker }执行sudo systemctl restart docker使配置生效3. Docker核心概念速成3.1 镜像(Image)与容器(Container)镜像如同软件安装包如wordpress:latest容器镜像运行后的实例可多个类比理解镜像 食谱配方容器 按配方做好的菜3.2 必备CLI命令# 镜像管理 docker pull nginx:alpine # 拉取镜像 docker image ls # 查看镜像 docker rmi IMAGE_ID # 删除镜像 # 容器管理 docker ps -a # 查看所有容器 docker start/stop CONTAINER # 启停容器 docker rm CONTAINER # 删除容器 # 日志查看 docker logs -f --tail 100 CONTAINER3.3 端口映射原理容器通过-p参数实现网络暴露docker run -p 8080:80 nginx表示将容器内80端口映射到主机8080端口4. 飞牛NAS上的Docker实战4.1 图形化部署以Jellyfin为例在应用中心安装「Portainer」或「Docker Compose UI」搜索jellyfin/jellyfin镜像配置参数卷映射/volume1/media:/media端口8096:8096环境变量TZAsia/Shanghai4.2 命令行部署以Transmission为例docker run -d \ --nametransmission \ -e PUID1000 \ -e PGID1000 \ -e TZAsia/Shanghai \ -p 9091:9091 \ -p 51413:51413 \ -v /volume1/downloads:/downloads \ -v /volume1/appdata/transmission:/config \ --restart unless-stopped \ linuxserver/transmission4.3 一键部署脚本应用飞牛社区用户分享的典型脚本结构#!/bin/bash APP_NAMEnextcloud DATA_DIR/volume1/docker_data/$APP_NAME mkdir -p $DATA_DIR/{config,data,themes} docker run -d \ --name$APP_NAME \ -p 8888:80 \ -v $DATA_DIR/config:/var/www/html/config \ -v $DATA_DIR/data:/var/www/html/data \ -v $DATA_DIR/themes:/var/www/html/themes \ --restart always \ nextcloud:latest注意执行前需用chmod x script.sh添加执行权限5. 飞牛NAS专属技巧5.1 持久化存储方案飞牛OS的卷管理特性系统卷/volume1推荐存放容器数据数据卷/volume2如有第二块硬盘临时卷/tmp重启会丢失最佳实践-v /volume1/docker/plex:/config \ -v /volume1/media/movies:/movies \ -v /volume1/media/tv:/tv5.2 硬件加速配置针对视频转码需求如Plex/Emby# docker-compose.yml片段 devices: - /dev/dri:/dev/dri environment: - NVIDIA_VISIBLE_DEVICESall5.3 网络模式选择飞牛OS支持的网络类型模式适用场景示例bridge多容器隔离web应用host高性能网络视频服务器macvlan独立IPVoIP服务6. 常见问题排雷指南6.1 容器启动失败排查查看日志docker logs CONTAINER检查端口冲突netstat -tulnp | grep PORT验证卷权限ls -la HOST_PATH6.2 性能优化方案内存限制--memory 2g --memory-swap 4gCPU限制--cpus 1.5IO限制--device-read-bps /dev/sda:1mb6.3 备份与迁移容器打包docker commit CONTAINER backup-image docker save -o backup.tar backup-image数据卷备份tar -czvf volume_backup.tar.gz -C /volume1/docker_data .7. 进阶Docker Compose实战7.1 编写docker-compose.yml典型结构示例version: 3.8 services: wordpress: image: wordpress:php8.2 ports: - 8000:80 volumes: - wp_data:/var/www/html environment: WORDPRESS_DB_HOST: db WORDPRESS_DB_USER: wpuser WORDPRESS_DB_PASSWORD: wppass db: image: mariadb:10.6 volumes: - db_data:/var/lib/mysql environment: MYSQL_ROOT_PASSWORD: rootpass MYSQL_DATABASE: wpdb MYSQL_USER: wpuser MYSQL_PASSWORD: wppass volumes: wp_data: db_data:7.2 飞牛OS集成技巧将compose文件放在/volume1/docker_compose创建快捷启动脚本#!/bin/bash cd /volume1/docker_compose/wordpress docker-compose up -d添加到「计划任务」实现开机自启8. 安全防护要点8.1 最小权限原则避免使用--privileged指定非root用户运行docker run -u 1000:1000 ...8.2 网络隔离方案创建自定义网络docker network create --subnet172.20.0.0/24 internal_net docker run --networkinternal_net ...8.3 镜像安全扫描使用Trivy进行漏洞检测docker run --rm \ -v /var/run/docker.sock:/var/run/docker.sock \ aquasec/trivy image nginx:latest9. 飞牛NAS特色应用推荐9.1 媒体中心组合graph LR A[飞牛影视] --|元数据| B(TinyMediaManager) A --|播放| C(Jellyfin) B --|整理| D(FileBot)9.2 智能家居套件Home AssistantNode-REDMosquitto MQTT9.3 开发工具链VS Code ServerGitLab CEJenkins10. 性能监控与维护10.1 资源监控方案内置工具docker stats可视化方案Portainer资源面板cAdvisor Prometheus Grafana10.2 日志管理进阶ELK栈部署示例# docker-compose.yml services: elasticsearch: image: elasticsearch:8.6.2 environment: - discovery.typesingle-node volumes: - es_data:/usr/share/elasticsearch/data kibana: image: kibana:8.6.2 ports: - 5601:5601 depends_on: - elasticsearch10.3 自动化维护脚本#!/bin/bash # 自动清理7天前的容器日志 find /volume1/docker/containers -name *.log -mtime 7 -delete # 清理悬空镜像 docker image prune -f # 重启异常容器 docker ps -q --filter statusexited | xargs docker restart
