基于原版 File Browser，本项目在源码基础上进行了以下重要增强：
功能描述： 在文件列表中新增了 "拥有者" 和 "权限" 两列，提供更详细的文件系统信息。
实现思路：
- 后端：扩展文件信息结构体，添加
Owner和Perm字段 - 前端：修改文件列表组件，增加对应的表格列显示
相关文件修改：
files/file.go- 扩展文件信息获取逻辑frontend/src/components/files/Listing.vue- 前端列表显示组件
功能描述： 在文件夹的详细信息（info）中显示文件夹的总大小，包含所有子文件和子文件夹。
实现思路：
- 递归遍历文件夹结构计算总大小
- 采用异步计算避免阻塞主线程
- 前端增加加载状态提示，避免目录较大时长时间显示为 0
相关文件修改：
http/resource.go- 新增/api/size目录大小统计接口frontend/src/components/prompts/Info.vue- info 弹窗展示目录总大小并显示加载状态
功能描述： 编辑器在移动设备上自动切换为简单文本编辑模式，解决 ACE 编辑器在移动设备上复制粘贴问题(ACE编辑器在移动设备上操作真离谱)。
实现思路：
- 设备检测：通过 User Agent 和屏幕宽度判断移动设备
- 自动切换：移动设备默认使用 textarea，桌面设备使用 ACE 编辑器
- 保留手动切换功能，用户可根据需要在两种模式间切换
检测逻辑：
const isMobile = () => {
return /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(navigator.userAgent) ||
window.innerWidth <= 768;
};相关文件：
frontend/src/views/files/Editor.vue- 编辑器主组件
功能描述： 集成 OnlyOffice 文档服务器，支持 Word、Excel、PowerPoint 等 Office 文档的在线预览和编辑。
架构设计：
- 后端集成： 新增 OnlyOffice 配置和 API 接口
- 前端组件： 嵌入 OnlyOffice 编辑器组件
- 设置管理： 管理员可配置 OnlyOffice 服务器地址
- 文件支持： 支持 .docx, .xlsx, .pptx 等主流格式
实现要点：
-
后端配置结构：
type OnlyOfficeConfig struct { Enabled bool `json:"enabled"` Host string `json:"host"` FileBrowserURL string `json:"filebrowserUrl"` ForceSave bool `json:"forceSave"` JwtSecret string `json:"jwtSecret"` }
-
前端设置界面：
- 启用/禁用 OnlyOffice 集成的开关
- OnlyOffice 服务器地址配置
- FileBrowser 内网地址（供 OnlyOffice 服务器侧拉取/回调使用）
- 强制保存回调（ForceSave）开关
- 支持的文件格式说明
-
文档编辑流程：
- 检测文件类型是否支持 OnlyOffice
- 前端通过后端接口获取 OnlyOffice 完整配置（包含 token、document.url、callbackUrl）
- 动态加载 OnlyOffice DocsAPI 并初始化编辑器
- 处理文档保存回调
-
API 接口说明：
-
/api/onlyoffice/mapping(POST)- 功能：获取 OnlyOffice 编辑器配置
- 请求参数：文件路径、文件名、修改时间、用户信息（userId/username）
- 返回：完整的 OnlyOffice 配置对象（包含文档信息、编辑器配置、JWT令牌等）
- 用途：前端初始化 OnlyOffice 编辑器时调用
-
/api/onlyoffice/callback(POST)- 功能：处理 OnlyOffice 文档服务器的回调
- 请求参数：文档状态、下载URL、用户操作等
- 返回：处理结果状态
- 用途：文档编辑完成后自动保存到文件系统
-
-
性能优化（推荐）：OnlyOffice↔FileBrowser 走内网
- 背景：OnlyOffice Document Server 是“服务器端”拉取
document.url，并向callbackUrl回调保存。如果这两个 URL 指向公网域名，会导致文件在公网绕一圈（慢且浪费带宽）。 - 方案：浏览器仍通过公网域名访问 FileBrowser/OnlyOffice；但服务器互访使用内网地址。
- 配置：设置
onlyoffice.filebrowserUrl为 OnlyOffice 容器可直连的地址，例如http://filebrowser:80（同 docker network 的 service name）。 - 效果：打开文档时 OnlyOffice 拉取文件走内网；保存回调也走内网，整体延迟明显下降。
- 背景：OnlyOffice Document Server 是“服务器端”拉取
-
保存回写（推荐）：ForceSave 让“点保存就更新”
- 背景：OnlyOffice 默认常见行为是“关闭文档时”才触发最终保存回调（status=2），所以你会看到点保存但 FileBrowser 文件不更新。
- 方案：启用
onlyoffice.forceSave，让 OnlyOffice 在用户点击保存时触发 force save 回调（status=6），后端收到回调后下载callback.url并覆盖写回原文件。 - 注意：需要保证 FileBrowser 可以访问 OnlyOffice 提供的
callback.url（建议同样通过内网可达）。
Docker 部署示例：
Dockerfile里面的uid调整为99:100
./build 1.0.0
# 启动 OnlyOffice 文档服务器
docker run -d --name onlyoffice-docs \
-p 6066:80 \
-e TZ=Asia/Shanghai \
-e JWT_ENABLED=true \
-e JWT_SECRET=xxxxxxxx \
onlyoffice/documentserver:9.3
文档解除大小限制
docker exec office sed -i -e 's/104857600/504857600/g' /etc/onlyoffice/documentserver/default.json
docker exec office sed -i -e 's/50MB/500MB/g' /etc/onlyoffice/documentserver/default.json
docker exec office sed -i -e 's/104857600/1048576000/g' /etc/onlyoffice/documentserver-example/production-linux.json
docker exec office service nginx restart
docker exec office supervisorctl restart all相关文件修改：
settings/settings.go- 添加 OnlyOffice 配置http/onlyoffice.go- OnlyOffice API 接口frontend/src/views/settings/Global.vue- 设置界面
功能描述： 面包屑默认最多显示 9 级路径，超出部分以 ... 折叠，避免路径过深时 UI 过长。
相关文件：
frontend/src/components/Breadcrumbs.vue
功能描述： 在侧边栏添加目录树组件，提供直观的文件系统导航，支持快速展开/折叠文件夹，自动展开到当前浏览路径。
实现思路：
- 组件化设计：独立的
DirectoryTree和TreeNode组件 - 按需加载：只在展开文件夹时加载子目录，避免一次性加载大量数据
- 路径同步：自动展开到当前访问路径
- 响应式布局：集成到 Sidebar 中，利用 Flex 布局占据剩余空间
功能特性：
- 点击目录树节点直接导航到对应目录
- 支持展开/折叠文件夹
- 显示加载状态
- 自动展开到当前浏览路径
- 刷新按钮重新加载目录树
- 当前路径高亮显示
相关文件：
frontend/src/components/DirectoryTree.vue- 目录树主组件frontend/src/components/TreeNode.vue- 树节点组件frontend/src/components/Sidebar.vue- 侧边栏集成frontend/src/css/base.css- 侧边栏样式调整frontend/src/i18n/locales/en.json- 英文翻译frontend/src/i18n/locales/zh-cn.json- 中文翻译
功能描述： 允许管理员在全局设置中配置快捷访问路径，这些路径会在侧边栏以目录树的形式显示，方便快速访问常用目录。
实现思路：
- 后端配置：扩展 Settings 结构体，添加
QuickAccessPaths字段 - 前端设置：在 Global Settings 中添加配置界面，支持多行输入
- 组件化：独立的
QuickAccessTree组件，支持多个根路径 - 目录树：每个配置的路径作为独立的根节点，支持展开/折叠
功能特性：
- 支持配置多个快捷访问路径
- 每个路径作为独立的目录树节点显示
- 支持展开/折叠查看子文件和子文件夹
- 点击文件或文件夹直接导航到对应位置
- 配置支持通过设置界面保存
相关文件：
settings/settings.go- 扩展 Settings 结构体http/settings.go- API 支持新配置字段frontend/src/types/settings.d.ts- 类型定义frontend/src/views/settings/Global.vue- 设置界面frontend/src/components/QuickAccessTree.vue- 快捷访问树组件frontend/src/components/Sidebar.vue- 侧边栏集成
- 后端： Go 1.23, 基于原有架构扩展
- 前端： Vue 3 + TypeScript, 保持原有技术栈
- 文档服务： OnlyOffice Document Server
- 部署： 支持 Docker 容器化部署
filebrowser provides a file managing interface within a specified directory and it can be used to upload, delete, preview, rename and edit your files. It allows the creation of multiple users and each user can have its own directory. It can be used as a standalone app.
Warning
This project is currently on maintenance-only mode, and is looking for new maintainers. For more information, please read the discussion #4906. Therefore, please note the following:
- It can take a while until someone gets back to you. Please be patient.
- Issues are only being used to track bugs. Any unrelated issues will be converted into a discussion.
- No new features will be implemented until further notice. The priority is on triaging issues and merge bug fixes.
If you're interested in maintaining this project, please reach out via the discussion above.
File Browser is a create-your-own-cloud-kind of software where you can install it on a server, direct it to a path and then access your files through a nice web interface. You have many available features!
| Easy Login System | Sleek Interface | User Management |
|---|---|---|
 |
 |
 |
| File Editing | Custom Commands | Customization |
|---|---|---|
 |
 |
 |
For information on how to install File Browser, please check docs/installation.md.
For information on how to configure File Browser, please check docs/configuration.md.
Contributions are always welcome. To start contributing to this project, read our guidelines first.
Apache License 2.0 © File Browser Contributors