
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
latest标签已移除(2020-03-01)## 初始用户名:admin## 初始密码:admin## 全球功能最强大的filebrowser/filebrowser分支版本!## 镜像概述和主要用途filebrowser增强版(FBE)是基于filebrowser/filebrowser的功能扩展版本,专为amd64和arm64架构设备优化。它提供直观的Web界面文件管理功能,支持硬件编码、ACME自动HTTPS证书申请、多平台NAS适配等增强特性,适用于个人或企业的文件浏览、管理和媒体文件处理场景。## 核心功能和特性-** 多架构支持 **:兼容amd64和arm64设备,满足不同硬件平台需求。-** 硬件编码 :支持Intel CPU的硬件编解码(需Intel Quick Sync Video支持),提升媒体文件处理效率。 - 自动HTTPS :集成ACME协议,可通过DNS提供商自动申请Let's Encrypt证书,简化HTTPS配置。 - 灵活的卷映射 :针对Synology、QNAP、NanoDM等NAS设备提供专属卷映射方案,方便管理多卷文件。 - 丰富的环境变量配置 :支持用户ID/组ID设置、端口自定义、SSL开关、JWT令牌过期时间等参数调整。 - 后台任务管理 **:支持文件解压、缩略图生成、种子制作等异步任务,提升操作体验。
--device=/dev/dri/renderD128:/dev/dri/renderD128参数即可启用硬件编码。### 硬件编码注意事项目前仅支持Intel CPU,需确认CPU是否支持硬件编解码:- Intel Quick Sync Video支持列表ls -ld /volume*查看卷数量。假设有/volume1和/volume2,映射方式如下:ini/volume1 => /myfiles/volume1/volume2 => /myfiles/volume2#### 卷映射特殊提示:QNAP NAS用户若需FBE管理所有卷文件,直接映射/share目录至/myfiles:ini/share => /myfiles#### 卷映射特殊提示:NanoDM用户若需FBE管理所有卷文件,直接映射/media目录至/myfiles:ini/media => /myfiles### 环境变量#### 容器基础变量| 名称 | 默认值 | 描述 |
|:--------------------------|:--------------|:-------------------------------------------------------------------------------------------------------------------|
| PUID | 1000 | 运行用户ID |
| PGID | 100 | 运行用户组ID |
| UMASK_SET | 000 | 应用运行用户的umask值 |
| WEB_PORT | 8082 | HTTP/HTTPS监听端口 |
| FB_SSL | off | 设置为on以启用HTTPS,使用/config/ssl/目录下的自定义证书 |
| AUTOCERT_DOMAIN | localhost | 若启用ACME,设置为ACME域名(可多个,如foo.com,b.bar.com,支持通配符*.foo.com) |
| AUTOCERT_DOMAIN_WHITELIST | | 允许的域名列表(为空表示允许所有,可多个,如foo.com,b.bar.com) |
| AUTOCERT_DNS_PROVIDER | | 详见下方支持的DNS提供商 |
| AUTOCERT_KEYTYPE | EC256 | 证书类型,可选RSA2048/RSA4096/RSA8192/EC256/EC384 |#### FBE专属变量| 名称 | 命令行参数 | 默认值 | 描述 |
|:--------------------|:--------------|:--------------|:--------------------------------------------------------------------|
| WEB_PORT代替 |
| FB_BASEURL | -b, --baseurl | | 基础URL,必须以/开头且不以/结尾 |
| FB_ADDRESS | -a, --address | | 监听地址,容器内建议设为0.0.0.0 |
| FB_ROOT | -r, --root | | FBE根路径,容器内强制为/myfiles |
| FB_CERT | -t, --cert | | TLS证书文件路径 |
| FB_KEY | -k, --key | | TLS密钥文件路径 |
| FB_AUTH_EXP_HOUR | | 24 | JWT令牌过期时间(小时) |
| FB_AUTH_SERVER_ADDR | | 127.0.0.1 | 可选,用于与NanoDm面板自动认证的面板IP |### TLS相关环境变量### ACME DNS提供商额外环境变量bash# ACME相关环境变量# ACME检查间隔(小时),默认24小时GO_ACME_INTERVAL=24# 测试时可设置为Let's Encrypt staging服务器:https://acme-staging-v02.api.letsencrypt.org/directoryGO_ACME_CA_SERVER=""# ACME HTTP代理(如需要)HTTP_PROXY=""AUTOCERT_EMAIL=""# ACME域名(可多个,支持通配符)AUTOCERT_DOMAIN=""# 证书类型AUTOCERT_KEYTYPE=EC256# ACME DNS提供商(默认cloudflare)AUTOCERT_DNS_PROVIDER=cloudflare# Cloudflare DNS提供商专用:API令牌CF_DNS_API_TOKEN=""# ACME私钥文件路径(需与FB_KEY一致)GO_ACME_KEY_PATH="/config/ssl/ssl.key"# ACME证书文件路径(需与FB_CERT一致)GO_ACME_CERT_PATH="/config/ssl/ssl.crt"# ACME证书缓存目录GO_ACME_STORAGE_DIR="/config/ssl"#### 支持的DNS提供商bashalidns,azure,cloudflare,cloudxns,digitalocean,dnspod,gcloud,linodev4,namecheap,qcloud,rfc2136,vultr##### Cloudflare配置> 从"My Profile -> API Tokens"获取令牌,需包含权限:Zone.Zone: Read、Zone.DNS: Edit、Zone Resources: All zones| 环境变量 | 描述 |
|:--------------------------|:--------------|
| CF_DNS_API_TOKEN | API令牌 |##### DNSPod配置| 环境变量 | 描述 |
|:--------------------------|:--------------|
| DNSPOD_API_KEY | 格式:id,token |##### 腾讯云(qcloud)配置| 环境变量 | 描述 |
|:--------------------------|:--------------|
| QCLOUD_SECRET_ID | SecretId |
| QCLOUD_SECRET_KEY | SecretKey |##### 阿里云(alidns)配置| 环境变量 | 描述 |
|:--------------------------|:--------------|
| ALICLOUD_ACCESS_KEY | Access key ID |
| ALICLOUD_SECRET_KEY | Access Key secret |其他提供商配置参考:https://go-acme.github.io/lego/dns/#dns-providers### ACME测试说明测试时需将ACME端点改为staging服务器,避免触发生产环境速率限制:bashGO_ACME_CA_SERVER="https://acme-staging-v02.api.letsencrypt.org/directory"## 配置文件路径| 容器路径 | 描述 |
|:----------------------------|:-------------------|
| /config/.filebrowser.toml | 配置文件 |
| /config/database.db | 数据库文件 |
| /config/ssl/ssl.crt | SSL证书文件 |
| /config/ssl/ssl.key | SSL密钥文件 |## 运行示例> 注意:将$HOME/docker/fb/config和$HOME/docker/fb/myfiles替换为实际路径,** 不要直接复制粘贴 **!标签
2.9.3-amd64更新频率较低,根据需求替换为最新标签;arm64设备使用2.9.3-arm64。#### HTTP模式shellIMAGE_NAME=80x86/filebrowserWEB_PORT=8082FB_AUTH_SERVER_ADDR="127.0.0.1"mkdir -p $HOME/docker/fb/config $HOME/docker/fb/myfilespodman run -d --name fb \ --restart=unless-stopped \ -e PUID=$UID \ -e PGID=$GID \ -e WEB_PORT=$WEB_PORT \ -e FB_AUTH_SERVER_ADDR=$FB_AUTH_SERVER_ADDR \ -p $WEB_PORT:$WEB_PORT \ -v $HOME/docker/fb/config:/config \ -v $HOME/docker/fb/myfiles:/myfiles \ --mount type=tmpfs,destination=/tmp \ ${IMAGE_NAME}:2.9.3-amd64#### HTTP+硬件编码模式添加--device=/dev/dri/renderD128:/dev/dri/renderD128参数:shellIMAGE_NAME=80x86/filebrowserWEB_PORT=8082FB_AUTH_SERVER_ADDR="127.0.0.1"mkdir -p $HOME/docker/fb/config $HOME/docker/fb/myfilespodman run -d --name fb \ --restart=unless-stopped \ --device=/dev/dri/renderD128:/dev/dri/renderD128 \ -e PUID=$UID \ -e PGID=$GID \ -e WEB_PORT=$WEB_PORT \ -e FB_AUTH_SERVER_ADDR=$FB_AUTH_SERVER_ADDR \ -p $WEB_PORT:$WEB_PORT \ -v $HOME/docker/fb/config:/config \ -v $HOME/docker/fb/myfiles:/myfiles \ --mount type=tmpfs,destination=/tmp \ ${IMAGE_NAME}:2.9.3-amd64#### HTTPS模式添加-e FB_SSL=on参数:shellIMAGE_NAME=80x86/filebrowserWEB_PORT=8082FB_AUTH_SERVER_ADDR="127.0.0.1"mkdir -p $HOME/docker/fb/config $HOME/docker/fb/myfilespodman run -d --name fb \ --restart=unless-stopped \ -e PUID=$UID \ -e PGID=$GID \ -e WEB_PORT=$WEB_PORT \ -e FB_SSL=on \ -e FB_AUTH_SERVER_ADDR=$FB_AUTH_SERVER_ADDR \ -p $WEB_PORT:$WEB_PORT \ -v $HOME/docker/fb/config:/config \ -v $HOME/docker/fb/myfiles:/myfiles \ --mount type=tmpfs,destination=/tmp \ ${IMAGE_NAME}:2.9.3-amd64#### 启用ACME自动HTTPS(以Cloudflare为例)添加ACME相关环境变量:shellIMAGE_NAME=80x86/filebrowserWEB_PORT=8082FB_AUTH_SERVER_ADDR="127.0.0.1"mkdir -p $HOME/docker/fb/config $HOME/docker/fb/myfilesdocker run -d --name fb \ --restart=unless-stopped \ -e PUID=$UID \ -e PGID=$GID \ -e WEB_PORT=$WEB_PORT \ -e FB_AUTH_SERVER_ADDR=$FB_AUTH_SERVER_ADDR \ -e FB_SSL=on \ -e AUTOCERT_EMAIL=your-email-for-acme \ -e AUTOCERT_DOMAIN=you-domain.com \ -e AUTOCERT_DNS_PROVIDER=cloudflare \ -e CF_DNS_API_TOKEN="your-cf-token-here" \ -p $WEB_PORT:$WEB_PORT \ -v $HOME/docker/fb/config:/config \ -v $HOME/docker/fb/myfiles:/myfiles \ --mount type=tmpfs,destination=/tmp \ ${IMAGE_NAME}:2.9.3-amd64## 与原版对比https://raw.githubusercontent.com/ttys3/filebrowser-enhanced/master/FBvsFBE.pnghttps://raw.githubusercontent.com/ttys3/filebrowser-enhanced/master/FBvsFBE.zh.png## 更新日志-** 2.9.3 **- 修复重命名权限问题
/开头且不以/结尾AUTOCERT环境变量,ACME功能由auto-acme提供GO_ACME_KEY_PATH和GO_ACME_CERT_PATHSSL重命名为FB_SSL-** 2.9.2 **- 恢复v2.8.3中移除的baseurl参数
-** 2.9.1 **- 更新分词引擎,使用Golang 1.4.0构建
-** 2.9.0 **- 新增标签2.9.0-amd64和2.9.0-arm64,latest标签未更新,请勿使用
-** 2.8.6 **- 视频嵌入字幕选择功能
-** 2.8.4 **- 移除环境变量INDEXED_SEARCH/INDEX_DIR/INDEX_INTERVAL/CACHE_DIR,可在FBE设置中配置
-** 2.8.3 **- 修复键盘t键绑定
-** 2.8.2 **- 设置:修复字段集样式
-** 2.8.1 **- 替换blueimp画廊(移动端全屏问题),新增带过渡效果的画廊
-** 2.7.2 **- 照片画廊:新增"显示指示器"选项(默认禁用)
-** 2.7.1 **- 新增转码功能,支持h.265、mov、wmv、avi、flv等格式播放
-** 2.6.9 **- 新增缩略图配置,支持控制图片缩略图宽度、视频缩略图宽度/数量/列数
-** 2.6.8 **- 修复密码重命名问题
CACHE_DIR环境变量以下是 80x86/filebrowser 相关的常用 Docker 镜像,适用于 不同场景 等不同场景:
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。





来自真实用户的反馈,见证轩辕镜像的优质服务