极空间部署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 = 你的私人"网盘后台" + "网页版资源管理器"

✅ 核心特点

特性	说明
可视化界面	类似 Windows资源管理器或macOS Finder的网页界面，支持文件预览、拖拽上传、右键菜单等操作。
多用户与权限控制	支持创建多个用户，可为每个用户分配不同的目录访问权限（只读/读写）、配额限制等。
文件操作丰富	支持上传、下载、重命名、删除、压缩（ZIP）、解压、新建文本/文件夹、复制/移动等。

典型应用场景

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

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

2.前提条件

2.1ssh远程连接到极空间

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

shell 复制代码

ssh root@IP

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

2.2验证docker是否开启

使用命令：

shell 复制代码

docker -v 
systemctl status -v

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

3.安装File Browser

shell 复制代码

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

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

shell 复制代码

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

shell 复制代码

touch /docker/filebrowser/db/database.db

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

shell 复制代码

docker pull filebrowser/filebrowser

shell 复制代码

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

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

shell 复制代码

docker rm -f filebrowser

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

shell 复制代码

docker logs filebrowser

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

4.使用File Browser

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

shell 复制代码

 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步骤：

使用一键脚本安装命令：

shell 复制代码

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

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

shell 复制代码

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文件管理入口的基础流程。