保姆级教程：用Docker Compose在群晖NAS上5分钟搞定FileRun私有网盘（附中文汉化包）
群晖NAS极速部署FileRun私有云盘：Docker Compose一站式解决方案
1. 为什么选择FileRun作为私有云盘？
最近两年，越来越多的用户开始关注数据隐私和自主控制的需求。我身边不少朋友都在寻找既简单易用又能完全掌控的私有云方案。在试用了NextCloud、Seafile等多个开源产品后，我发现FileRun在轻量化和易用性上有着独特优势。
FileRun是一个功能完备的Web文件管理器，界面设计直观，响应速度快。它原生支持多用户管理、文件预览、在线编辑等核心功能，而且对硬件资源要求不高，特别适合在群晖NAS上部署。与NextCloud相比，FileRun更专注于文件管理本身，去掉了许多普通用户用不到的复杂功能，这让它的运行效率更高，配置也更简单。
FileRun的三大核心优势：
- 极简部署：单容器架构，5分钟即可完成安装
- 开箱即用：无需复杂配置，界面直观易懂
- 资源友好：内存占用低，适合长期运行在NAS上
2. 环境准备与Docker Compose部署
2.1 前置条件检查
在开始之前，请确保你的群晖NAS满足以下要求：
- DSM 6.2或更新版本
- 已安装Docker套件
- 至少1GB可用内存
- 熟悉群晖的基本文件管理操作
提示：虽然FileRun支持SQLite，但建议使用MariaDB以获得更好性能。群晖套件中心提供了MariaDB 10，安装后记得创建一个空数据库（如filerun）。
2.2 Docker Compose vs 纯Docker命令
很多教程会教你用docker run命令一步步部署，但实际使用中我发现docker-compose方式有明显优势：
| 对比项 | Docker命令 | Docker Compose |
|---|---|---|
| 配置管理 | 参数分散在命令行中 | 集中在一个yml文件中 |
| 可维护性 | 修改配置需要重新输入完整命令 | 只需编辑yml文件后重启 |
| 可读性 | 长串参数不易阅读 | 结构化YAML清晰明了 |
| 扩展性 | 添加服务复杂 | 轻松定义多容器应用 |
基于这些优势，我强烈推荐使用docker-compose方式部署FileRun。
2.3 一键部署实战
首先在群晖的docker目录下创建项目文件夹结构：
mkdir -p /volume1/docker/filerun/{html,user-files}然后创建docker-compose.yml文件，内容如下：
version: '3' services: filerun: image: filerun/filerun:latest container_name: filerun restart: unless-stopped ports: - "8080:80" volumes: - ./html:/var/www/html - ./user-files:/user-files environment: FR_DB_HOST: 192.168.1.100 # 替换为你的MariaDB服务器IP FR_DB_NAME: filerun FR_DB_USER: filerun FR_DB_PASS: your_strong_password APACHE_RUN_USER: www-data APACHE_RUN_USER_ID: 33 APACHE_RUN_GROUP: www-data APACHE_RUN_GROUP_ID: 33保存后，只需一条命令即可启动服务：
docker-compose up -d3. 中文语言包安装与优化
3.1 获取可靠的中文语言包
FileRun官方仓库的语言包目前是空的，经过多次测试，我发现这个社区维护的中文包最完整：
wget https://example.com/path/to/chinese.php -O /volume1/docker/filerun/html/system/data/translations/chinese.php注意：某些浏览器缓存可能导致语言切换不生效。如果遇到这种情况，尝试清除缓存或使用隐私模式访问。
3.2 语言包安装的两种方式
方法一：直接文件上传
- 登录FileRun后台
- 进入"控制面板" → "界面选项"
- 在语言设置处上传chinese.php文件
方法二：手动放置文件
- 通过SSH或File Station将chinese.php放入：
/volume1/docker/filerun/html/system/data/translations/- 刷新页面后即可在设置中选择中文
3.3 浏览器兼容性处理
在实际测试中，我发现不同浏览器对语言包的支持有差异：
| 浏览器 | 语言切换效果 | 建议操作 |
|---|---|---|
| Chrome | 可能不完整 | 清除缓存或使用隐身模式 |
| Edge | 完全支持 | 推荐使用 |
| Firefox | 完全支持 | 推荐使用 |
| Safari | 基本支持 | 可能需要刷新多次 |
4. 高级配置与日常维护
4.1 反向代理设置（可选）
如果你希望通过域名访问FileRun，可以在群晖控制面板中设置反向代理：
- 进入"控制面板" → "应用程序门户" → "反向代理"
- 添加新规则，配置如下：
| 设置项 | 值 |
|---|---|
| 来源协议 | HTTPS |
| 来源主机名 | yourdomain.com |
| 来源端口 | 443 |
| 目标协议 | HTTP |
| 目标主机名 | localhost |
| 目标端口 | 8080 |
4.2 定期备份策略
为确保数据安全，建议设置以下备份计划：
数据库备份：
mysqldump -u filerun -p filerun > /path/to/backup/filerun_$(date +%Y%m%d).sql用户文件备份：
- 定期压缩
user-files目录 - 使用群晖Hyper Backup套件设置自动备份
- 定期压缩
配置文件备份：
- 备份docker-compose.yml文件
- 备份html目录中的系统文件
4.3 性能优化技巧
- 缓存配置：在
html/.htaccess中添加缓存规则 - 图片缩略图：调整
html/system/classes/thumbnails.php中的生成参数 - 定期维护：每月执行一次
docker system prune清理无用镜像
5. 常见问题排查
Q1: 安装后无法访问Web界面
- 检查防火墙是否放行了8080端口
- 查看容器日志：
docker logs filerun - 确认MariaDB连接信息正确
Q2: 上传文件大小受限
- 修改php.ini中的上传限制：
upload_max_filesize = 256M post_max_size = 256M - 重启容器使配置生效
Q3: 中文文件名显示乱码
- 确保数据库使用utf8mb4字符集
- 检查Apache的AddDefaultCharset设置
Q4: 内存占用过高
- 调整PHP内存限制：
memory_limit = 128M - 禁用不必要的预览生成功能
6. 实际使用体验分享
经过三个月的实际使用，FileRun在家庭和小型团队场景下表现相当稳定。我最欣赏它的几个特点：
文件预览功能完善：支持图片、文档、视频等多种格式的即时预览，省去了下载查看的麻烦。
权限管理灵活：可以为不同用户设置精确的文件夹访问权限，特别适合家庭共享使用。
移动端适配良好：在手机浏览器上操作也很流畅，基本不需要额外安装APP。
扩展性强：通过插件可以添加WebDAV支持、OCR识别等高级功能。
唯一需要注意的是，首次使用时最好花点时间熟悉它的权限系统设计，这与传统的Windows共享略有不同。设置得当后，日常使用几乎不需要维护干预。