Docker 安装私人网盘 : FileRun 最全指南
必读前言:
0. 先上图看静默状态下的内存占用:
因为我已经删除掉了宿主上的filebrowser和nextcloud,会打开看这篇文章的人相信你们应该有类似软件,可以比较下相关的docker内存占用情况.
1. filerun是极其轻量占用内存极小,只需要基础分配128M内存就能完美稳定运行不卡.不像nextcloud一样,臃肿不堪,虽然他是个为爱发电的开源项目,但是nextcloud在我刚安装完打开的时候,就卡的飞起飞起飞起,我是真的不能理解的.
他基于PHP语言编写的一款网盘应用.不是有个梗这么说的吗,PHP是世界上最好的编程语言.
作者是个大大大佬,但是本身并不开源,并且一开始是应用在树莓派上的,所以知道的人很少,其实作者维护了很多年了,近期的版本大更新又带来了更强大的功能.基础免费版对于日常家用就已经基本够用了
2. 不要问我有道云,nextcloud,filerun,seafile,filebrowser等等到底哪个好,我只会推荐他,因为我把上述安装过使用过的docker应用已经全部删除,只留了他.
流传网上的filerun教程都是浅尝辄止,如果你也跟我一样很喜欢或者很想尝试安装filerun,尤其是在unraid平台,那么你可以只看我这一篇集大成者.
因为之前我也是跟着别人的中文甚至英文帖子一步步部署,最后踩了不少的坑,尤其是权限分配处理这块,搞不好就会让你整个共享文件夹下面的appdata,system等系统级文件受到影响,后期改权限归属让你痛不欲生.
3. 如果你还有其他unraid方面的部署困扰,可以看看我发布的其他相关文章,一样是完全闭坑指南,也同样不推荐再去看其他家的指导文章.我的所有文章都是自己踩坑经历,并且主要是为了回溯方便自己记录在本地的.
发在值得买纯粹是为爱发电
,你要想,其实国内unraid的发展,我们现在玩的都是老外玩剩下的了,还要搞那些收费看教程的,就不可理喻
4. 除非大版本的改版,本篇内容持续有效.
5. 万字吐血手打整理,喜欢喷的现在就可以Alt+F4了,这篇文章不适合你.
如果你决定了要安装它,请多次复读本文内容,直到充分理解后再操作!文字内容虽少,但是句句精华.
安装配置选项
1. 安装前先在 appdatafilerunhtmlcustomizables 下手动新建一个 config.php 文件
没有目录就手动创建目录,注意和后面配置的阿帕奇用户的权限保持一致
mkdir -p /mnt/user/appdata/filerun/html/customizables
nano /mnt/user/appdata/filerun/html/customizables/config.php
粘贴下面内容到config.php文件
<?php
umask(000); #配置文件里的umask是不生效的,要在这里修改才能让其他用户如nobody不是只读
date_default_timezone_set("Asia/Shanghai"); # 时区
$config['path']['thumbnail_cache'] = '/var/www/html/cache'; # 缩略图更换路径,集中管理
$config['app']['upload']['max_simultaneous'] = 15; # 同时上传文件数
$config['thumbs']['limit_file_size'] = 20971520; # 默认略缩图大小限制为20MB
umask的修改参考来自 : https://forums.unraid.net/topic/119147-filerun-fix-default-permissions/#comment-1089794
+额外内容 : 可以添加下面这段,屏蔽文件夹读取
$config['app']['hidden_folder_names'][] = "appdata";
$config['app']['hidden_folder_names'][] = "appdata-backup";
$config['app']['hidden_folder_names'][] = "isos";
$config['app']['hidden_folder_names'][] = "domains";
$config['app']['hidden_folder_names'][] = "system";
ctrl+X , Y , Enter . 保存后记得修改 /appdata/filerun 文件夹的所有者
chown -R admin /mnt/user/appdata/filerun
这里有更多的官方高级配置文档说明 : https://docs.filerun.com/advanced_configuration
2. docker配置
docker中的 /user-files 文件夹不要直接映射到 /mnt/user/,可以用 /mnt/user/filerun/ 或者 /mnt/user1/ 这样的形式
使用硬链接的方式,把文件夹链接到 /mnt/user/filerun/ 文件夹中去以防被一锅端改了文件夹权限,影响系统环境
APACHE的用户UID和GID直接影响到映射后的 /mnt/user/filerun/ 文件夹的权限属性 ,以及后续在网盘中修改读写保存后的属性也是一样的
3. filerun应用内的设置
* 启动后打开webui,注意记录初始随机生成的密码
* 修改默认office文档的打开方式(libreoffice打开中文不显示), 也可以额外安装onlyoffice链接进来
* 开启API才能手机用nextcloud的app访问
* 授权
可以把最大用户从5个增加到10个(官方论坛没有注册入口,授权以后才能获得账号,在官方论坛发帖求助和评论)
授权后,本地内网就不能访问了,可以在 appdatafilerunhtmlsystemdata 删除 '.filerun.bin' 即可恢复
3.1 开启全文档搜索的方法
docs.filerun.com/file_indexing
3.2 windows端 : 链接资源管理器
3.2.1 打开我的电脑,空白处右键添加一个网络位置
3.2.2 下一步,下一步,输入网址 , 输入filerun的账号密码
https://ABC.DEF.GH/dav.php/@Home/
ABC.DEF.GH 替换成自己的域名
3.2.3 改个自己喜欢的名字
3.2.4 现在就可以远程办公场所直接访问了
3.3 移动端 :
移动端推荐使用nextcloud或者FE文件管理器
https://apps.apple.com/cn/app/nextcloud/id1125420102
踩坑
office中文乱码的临时解决方法(测试无效),建议有协同需求的直接docker另外安装onlyoffice
customizables/plugins/office_web_viewer/app.php 文件夹
$url = 'https://view.officeapps.live.com/op/embed.aspx?src='.urlencode($url);
改成
$url = 'https://view.officeapps.live.com/op/embed.aspx?src='.($url);
如果使用chrome遇到
这种情况,1.尝试修改/appdata/filerun下的php文件,2.以及关闭浏览器某些冲突插件,3.可以用无痕模式测试
<?php$config['url']['root'] = 'https://your-site/path-to-filerun/';$config['url']['detected_root'] = $config['url']['root'];
官网地址 : https://filerun.com/
作者声明本文无利益相关,欢迎值友理性交流,和谐讨论~

























web-1 | [Sat Jun 21 07:25:50.870012 2025] [autoindex:error] [pid 26] [client 172.27.0.1:53016] AH01276: Cannot serve directory /var/www/html/: No matching DirectoryIndex (index.php,index.html) found, and server-generated directory index forbidden by Options directive
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
web-1 | [Sat Jun 21 07:25:50.870012 2025] [autoindex:error] [pid 26] [client 172.27.0.1:53016] AH01276: Cannot serve directory /var/www/html/: No matching DirectoryIndex (index.php,index.html) found, and server-generated directory index forbidden by Options directive
校验提示文案
创建失败。
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案