二进制安装最稳，适合资源有限或未装docker的服务器；docker适合已有容器生态的环境，但必须显式挂载/config和/srv目录，否则重启丢数据。
直接装二进制最稳，不用 Docker 也能跑得干净利落，尤其适合没装 Docker 或只想轻量管理文件的服务器。
怎么选安装方式：二进制 vs Docker
二进制方式适合大多数 Linux 服务器，尤其是资源有限、不想引入 Docker 运行时的场景；Docker 方式适合已有容器生态、需要快速隔离或批量部署的环境。但注意：filebrowser/filebrowser:simple 镜像已停更，官方推荐用 filebrowser/filebrowser（无 tag 默认最新），且必须显式挂载配置和数据目录，否则重启后用户、权限全丢。
- 二进制：单文件、零依赖、启动快、日志/配置路径全可控
- Docker：需提前装好
docker-ce，-v必须绑定/config和/srv，否则数据库在容器内，一删容器就清空 - 别用一键脚本
curl | bash—— 官方 get.sh 已多年未维护，2026 年实测会卡在证书校验或下载失败
二进制安装：5 步走完，不依赖 root 权限也能跑
关键不是“能不能装”，而是“装完能不能长期稳定运行”。默认监听 127.0.0.1:8080，外网访问前必须改 --address，否则浏览器打不开。
- 下载最新版（比如 v2.40.1）：
wget https://github.com/filebrowser/filebrowser/releases/download/v2.40.1/linux-amd64-filebrowser.tar.gz - 解压并放到位：
tar -xzf linux-amd64-filebrowser.tar.gz && sudo mv filebrowser /usr/local/bin/ - 初始化配置库：
sudo filebrowser -d /etc/filebrowser.db config init（路径要写全，否则默认生成在当前目录） - 设监听地址和端口：
sudo filebrowser -d /etc/filebrowser.db config set --address 0.0.0.0 --port 8080 - 加管理员用户：
sudo filebrowser -d /etc/filebrowser.db users add admin password --perm.admin
启动命令：sudo filebrowser -d /etc/filebrowser.db --root /home/files（--root 决定用户能看到哪些文件，别漏掉）
启动后打不开？重点查这三处
不是“服务没起来”，而是“起起来了但被拦在外面”。常见现象是浏览器提示连接被拒绝，或 nginx 返回 502。
- 防火墙没开端口：
sudo ufw allow 8080（Ubuntu）或sudo firewall-cmd --permanent --add-port=8080/tcp（CentOS） -
--address还是127.0.0.1：执行filebrowser -d /etc/filebrowser.db config get确认输出里address是0.0.0.0 - SELinux 拦截（CentOS/RHEL）：
sudo setsebool -P httpd_can_network_connect 1，否则即使端口开着也连不上
想开机自启？systemd 是唯一靠谱方案
别用 nohup 或 screen，它们扛不住 reboot，也管不了进程崩溃重启。systemd 能真正实现“挂了自动拉起+日志可查”。
新建服务文件：sudo tee /etc/systemd/system/filebrowser.service，内容填：
[Unit] Description=FileBrowser After=network.target [Service] Type=simple User=root ExecStart=/usr/local/bin/filebrowser -d /etc/filebrowser.db --root /home/files Restart=on-failure RestartSec=10 [Install] WantedBy=multi-user.target
- 启用服务：
sudo systemctl daemon-reload && sudo systemctl enable --now filebrowser - 查状态：
sudo systemctl status filebrowser，看 Active 是否为active (running) - 看日志：
sudo journalctl -u filebrowser -f，比自己 redirect 到文件更可靠
复杂点在于 --root 路径必须有读写权限，且不能是 root 用户专属目录（如 /root）——systemd 以指定用户身份运行，权限不对就会静默失败。
