FileBrowser 免登录图片直链：容器部署 + Notion 嵌入完整指南

用 Notion 做知识库的朋友多半踩过这个坑：想往页面里嵌一张自己服务器上的图片，但 Notion 采集图片需要一个无需登录就能直接访问的图片 URL。FileBrowser 默认所有访问都要登录，直接把登录页面丢给采集器显然不行。

这篇文章分享我实际跑通的方案：Docker 部署 FileBrowser 做文件管理 + nginx 层开放 /static/ 免登录直链，让 Notion 无需任何账号密码就能嵌入图片，同时 FileBrowser 管理后台依然安全锁在登录后面。

适用：Notion 重度用户 / 自建图床 / 站长 ｜ 更新：2026-08-29

一、核心机制：免登录不是 FileBrowser 的功能

先澄清一个误区：免登录直链并不是 FileBrowser 自带的能力，而是 nginx 层用 alias 直接把图片目录映射出来，绕过 FileBrowser 的认证。

整条链路长这样：

Notion 页面
   │ 嵌入 https://files.example.com/static/<图片名>.jpg
   ▼
CDN (缓存静态文件)
   ▼
Nginx (443 SSL)
   ├── location /static/  → alias /data/images/   ← 免登录直链（本次重点）
   └── location /         → proxy_pass 127.0.0.1:8080   ← FileBrowser 页面（需登录）
   ▼
Docker filebrowser 容器 (8080, 仅本机可访问)

关键点：直链走的是 nginx 直接读磁盘，完全不经过 FileBrowser 的 8080 端口，所以绕过了认证；而 FileBrowser 页面本身仍走反代、仍需登录。两者互不干扰。

二、FileBrowser 容器部署

Docker 部署

docker run -d \
  --name filebrowser \
  --restart unless-stopped \
  -p 8080:80 \
  -v /data/images:/srv \
  -v /data/filebrowser-db:/database \
  -v filebrowser-config:/config \
  -e UID=1000 \
  -e GID=1000 \
  filebrowser/filebrowser:v2.63.14

三个关键挂载：

settings.json（容器内 /config/settings.json）

{
  "port": 80,
  "baseURL": "",
  "address": "",
  "log": "stdout",
  "database": "/database/filebrowser.db",
  "root": "/srv"
}

root: /srv 表示 FileBrowser 管理的就是图片目录，与直链目录一致，管理后台看到的内容和直链吐出的文件是同一份。

⚠️ 端口安全：8080 必须封死外网

容器端口经 docker-proxy 默认监听 0.0.0.0:8080，外网直连 8080 就等于把 FileBrowser 登录页暴露到公网。用 DOCKER-USER 链把外网访问 DROP 掉，只允许本机 nginx 反代访问：

iptables -I DOCKER-USER 1 -p tcp --dport 8080 -j DROP
iptables-save > /etc/iptables/rules.v4   # 持久化

实测效果：外网无法直连 8080，只能走 nginx 443 反代；而免登录直链走 nginx alias 直读磁盘、不经过 8080，不受这条限制，两条路各走各的。

三、nginx 反代配置（免登录直链核心）

1. 主反代：FileBrowser 页面（需登录）

location ^~ /
{
    proxy_pass http://127.0.0.1:8080;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $connection_upgrade;
    proxy_http_version 1.1;
}

2. ⭐ 免登录直链：Notion 嵌入的核心

新建一个独立的 location 配置（比如 static.conf）：

# 公开静态文件服务（无需认证），用于 Notion 图片嵌入
# 优先从本地磁盘服务，文件不存在时回退到 FileBrowser 后端
location /static/ {
    alias /data/images/;
    expires 30d;
    add_header Cache-Control "public, immutable";
    add_header Access-Control-Allow-Origin "*";
    try_files $uri @filebrowser;
}

# 回退到 FileBrowser 后端
location @filebrowser {
    proxy_pass http://127.0.0.1:8080;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

每一行的作用：

3. 生效

nginx -t && nginx -s reload

四、使用与验证

免登录直链 URL

https://files.example.com/static/<文件名>.jpg

三条验证命令

# 免登录直链（不带 cookie，期望: HTTP 200 image/jpeg）
curl -s -o /dev/null -w "HTTP %{http_code} type %{content_type} size %{size_download}\n" \
  "https://files.example.com/static/<文件名>.jpg"

# FileBrowser 页面（需登录，返回 SPA HTML，期望: 200 text/html）
curl -s -o /dev/null -w "%{http_code} %{content_type}\n" "https://files.example.com/"

# 受保护 API（无凭证，期望: 401）
curl -s -o /dev/null -w "%{http_code}\n" "https://files.example.com/api/raw/<文件名>.jpg"

三条全过，说明：直链公开可用、管理页仍受保护、API 没被误开放——安全性和可用性同时达标。

五、Notion 接入

1. 图片上传到服务器 /data/images/ 目录（或通过 FileBrowser 网页上传到根目录）
2. 在 Notion 页面嵌入：https://files.example.com/static/<文件名>.jpg
3. Notion 采集脚本/工具直接使用该 URL，无需任何认证头

为什么能嵌入 Notion：Access-Control-Allow-Origin: * + 公开 GET 直链 + CDN 缓存，三者缺一不可。缺 CORS 头的话浏览器会跨域拦截，Notion 页面里就是一片空白。

六、排障速查

总结

这套方案的价值在于用最小的改动解决了一个很实际的问题：FileBrowser 负责管理、nginx 负责公开，一个容器、一段 alias 配置，就把「私有文件管理」和「公开图片直链」安全地拆开了。Notion 嵌入图片从此不用再到处找图床，自己的服务器就是图床。

如果你也在折腾自建图床和 Notion 工作流，这套配置值得直接抄走。相关文章：

• Docker 镜像清理：从 17GB 瘦身到 1.5GB 的完整方案
• 宝塔 Nginx 缓存坑：改完内容不更新，根因与治本方案
• 2026 上半年 AI 工具盘点：哪些真正值得用