极空间部署File Browser：Docker搭建Web文件管理并实现远程访问

前言

NAS里的文件越来越多以后，除了使用设备自带的客户端，也可以增加一个独立的Web文件管理入口。这样在电脑或手机浏览器中就能完成文件浏览、上传、下载和部分权限管理，不需要额外安装文件管理客户端。

File Browser就是这样一套轻量的Web文件管理工具。它可以通过Docker运行在NAS中，并把指定的宿主机目录映射到网页中进行管理。需要注意的是，File Browser只能看到明确挂载给容器的目录，并不会自动获得整个极空间文件系统的访问权限。

本文会在极空间中通过Docker部署File Browser，配置持久化数据库和文件目录，再测试登录、用户创建、权限设置、上传和搜索等基础功能。实际部署时应只挂载真正需要通过Web管理的NAS目录，并根据容器UID/GID正确设置权限，不建议使用chmod 777作为长期权限方案。

完成局域网访问以后，还会通过cpolar为8088端口创建公网入口，用来从其他网络打开File Browser。由于这个页面能够直接读取、上传和删除文件，远程使用时应优先采用HTTPS、独立强密码和最小目录权限，而不能把公网地址本身当作访问保护。

1.什么是File Browser

File Browser是一款开源、轻量、跨平台的Web文件管理器，它能将任何支持Docker或直接运行二进制文件的服务器（包括NAS、树莓派、云主机、本地电脑等）快速转变为一个功能完整的在线文件管理系统。

简单来说：

File Browser = 你的私人“网盘后台” + “网页版资源管理器”

✅ 核心特点

典型应用场景

• 在 极空间、群晖、TrueNAS等NAS 上搭建私有网盘前端；
• 为远程服务器提供图形化文件管理入口；
• 快速共享大文件给同事或朋友（替代微信/QQ传文件）；
• 搭建家庭媒体库的管理后台；
• 替代FTP或Samba，用更现代的方式访问文件。

File Browser让你用浏览器就能像操作本地电脑一样，安全、高效地管理服务器或NAS上的所有文件——而且完全免费、开源、无厂商绑定。

2.前提条件

2.1ssh远程连接到极空间

• 开启【SSH 服务】
• 使用终端（Windows PowerShell / Mac Terminal）登录：

ssh root@IP

没有ssh的小伙伴可以参考cpolar官网这篇文章：《极空间别再吃灰了！开启SSH，秒变全能服务器！》

2.2验证docker是否开启

使用命令：

docker -v
systemctl status -v

没有docker的小伙伴可以参考cpola官网这篇文章：《极空间开箱实录：从拆箱到远程访问保姆级教程，30分钟上手！》

3.安装File Browser

首先创建一下安装的目录并进入到该目录：

mkdir -p /docker/filebrowser/{srv,config,db}
chmod -R 777 /docker/filebrowser/

创建两个个文件，确保后续运行正确:

cat > /docker/filebrowser/config/config.json <<EOF
{
"port": 80,
"baseURL": "",
"address": "",
"log": "stdout",
"database": "/etc/database.db",
"root": "/srv"
}
EOF

touch /docker/filebrowser/db/database.db

下载File Browser镜像（推荐使用这个命令，这是试了无数次错误总结出来的）：

docker pull filebrowser/filebrowser

docker run -d \\
–name filebrowser \\
–restart always \\
-v /docker/filebrowser/srv:/srv \\
-v /docker/filebrowser/config/config.json:/etc/config.json \\
-v /docker/filebrowser/db/database.db:/etc/database.db \\
-p 8088:80 \\
–user 1000:1000 \\
filebrowser/filebrowser

出现错误可以找日志解决，并删除容器重启：

docker rm -f filebrowser

登录密码怎么找？别急一条命令告诉你：

docker logs filebrowser

部署完成后，在浏览器中输入 http://极空间IP:8088 就能看到File Browser的界面：

4.使用File Browser

登录成功后的页面，我那三个文件夹怎么来的呢？，别急教你一个小妙招。

mkdir -p /srv/ubuntu/Prometheus
mkdir -p /srv/ubuntu/Debian
mkdir -p /srv/work
mkdir -p /srv/***

在运行容器前创建，开启页面后自动就出现啦！

首先我们尽量先改一个密码，因为他给的密码实在是太繁琐了，改成我们自定义的密码：

设置，语言改成中文更加便捷：

可以多用户使用，设置相关权限：

新增用户：

也可以自己创建文件夹：

上传文件或者文件夹：

也可以直接搜索相关文件，关键字即可：

再也不怕电脑没空间啦，因为我把文件都上传到了我的专属nas~

File Browser默认只能在局域网内访问（如 http://192.168.x.x:8088）。

但如果你在外网（比如公司、手机5G网络）想访问家里的文件，就需要一个内网穿透工具。

cpolar是一款简单易用的内网穿透工具，支持：

• 免费HTTPS访问
• 自定义域名（付费）
• 长期隧道（后台运行）
• 多平台（Linux / Windows / macOS / ARM）

通过cpolar，你可以把本地的File Browser服务暴露到公网，实现 “随时随地访问私有云”。

5.安装cpolar实现随时随地开发

5.1 什么是cpolar？

cpolar是一款安全高效的内网穿透工具，无需公网IP或复杂配置，只需一条命令，即可将本地服务器、Web服务或任意端口映射到公网，让你随时随地远程访问内网应用，特别适合开发调试、远程运维和应急部署等场景。

5.2 部署cpolar

cpolar 可以将你本地电脑中的服务（如 SSH、Web、数据库）映射到公网。即使你在家里或外出时，也可以通过公网地址连接回本地运行的开发环境。

❤️以下是安装cpolar步骤：

使用一键脚本安装命令：

sudo curl https://get.cpolar.sh | sh

安装完成后，执行下方命令查看cpolar服务状态：（如图所示即为正常启动）

sudo systemctl status cpolar

Cpolar安装和成功启动服务后，在浏览器上输入虚拟机主机IP加9200端口即:【http://ip:9200】访问Cpolar管理界面，使用Cpolar官网注册的账号登录,登录后即可看到cpolar web 配置界面,接下来在web 界面配置即可：

打开浏览器访问本地9200端口，使用cpolar账户密码登录即可,登录后即可对隧道进行管理。

6.配置公网地址

登录cpolar web UI管理界面后,点击左侧仪表盘的隧道管理——创建隧道：

• 隧道名称：可自定义，本例使用了:fb，注意不要与已有的隧道名称重复
• 协议：http
• 本地地址：8088
• 域名类型：随机域名
• 地区：选择China Top

创建成功后，打开左侧在线隧道列表,可以看到刚刚通过创建隧道生成了公网地址，接下来就可以在其他电脑或者移动端设备（异地）上，使用地址访问。

访问成功。

7.保留固定公网地址

使用cpolar为其配置二级子域名（cpolar官网-安全的内网穿透工具 | 无需公网ip | 远程访问 | 搭建网站），该地址为固定地址，不会随机变化。

点击左侧的预留，选择保留二级子域名，地区选择china Top，然后设置一个二级子域名名称，我使用的是fb，大家可以自定义。填写备注信息，点击保留。

登录cpolar web UI管理界面，点击左侧仪表盘的隧道管理——隧道列表，找到所要配置的隧道，点击右侧的编辑。

修改隧道信息，将保留成功的二级子域名配置到隧道中

• 域名类型：选择二级子域名
• Sub Domain：填写保留成功的二级子域名
• 地区: China Top

点击更新

更新完成后，打开在线隧道列表，此时可以看到随机的公网地址已经发生变化，地址名称也变成了保留和固定的二级子域名名称。

最后，我们使用固定的公网地址在任意设备的浏览器中访问，可以看到成功访问的页面，这样一个永久不会变化的二级子域名公网网址即设置好了。

总结

完成以上配置后，File Browser已经通过Docker运行在极空间中，并可以通过8088端口打开Web文件管理页面。

本文实际测试了登录、语言设置、用户创建、目录管理、文件上传和搜索等功能。File Browser能够管理哪些NAS数据，取决于Docker实际挂载给容器的目录，因此长期使用前应重新确认宿主机路径与容器/srv之间的映射关系，并避免把不需要远程管理的系统目录暴露给File Browser。

目录权限同样需要根据容器实际使用的UID和GID配置。直接把整个数据目录设置成777虽然可能暂时绕过部分权限错误，但会扩大本机访问范围；更合适的做法是让File Browser运行用户只拥有所需目录的必要读写权限，并单独备份重要数据。

通过cpolar为8088端口建立公网隧道后，还可以从其他网络环境进入File Browser。由于这里提供的是能够直接操作NAS文件的管理入口，远程访问时应优先使用HTTPS，并为管理员和普通用户分别设置独立强密码与最小权限，不建议把管理员入口作为公开文件分享页面使用。

如果需要长期使用同一个公网地址，可以根据实际套餐配置固定二级子域名，在账号、套餐以及对应隧道配置保持有效期间维持URL一致。固定地址解决的是访问链接变化问题，并不能替代File Browser账号安全、NAS备份以及服务可用性。

从Docker部署、目录挂载和用户权限，到远程文件管理，本文完成了一套在极空间上增加File Browser Web文件管理入口的基础流程。