FileCat 是一个需要自己部署的 Web 文件服务器，同时也是一款轻量级服务器管理工具。部署后，你可以随时随地通过浏览器管理服务器上的文件，并享受丰富的运维功能。

核心理念：以文件管理为核心，融合 AI Agent、远程桌面、内网穿透、系统监控等能力，让服务器管理变得更简单。

功能特性

| 类别 | 功能 | |------|---------------------------------------------------------------| | 文件管理 | 浏览、上传、下载、编辑、在线预览（图片、视频、Markdown、绘图等） | | AI Agent | 集成大语言模型，智能辅助运维和文件处理（需自行配置 API），支持接入 QQ， 企业微信 ，飞书 ，钉钉 第三方平台机器人 | | 内网穿透 | 将内网暴露到公网，或者多个内网之间互相通信 | | SSH 终端 | 浏览器内置 Web 终端，随时连接服务器 | | Windows 远程桌面 | 浏览器中直接操作远程 Windows 桌面（RDP） | | 系统信息看板 | 实时 CPU、内存、磁盘、网络等系统监控 | | CI/CD 工作流 | 支持自定义命令流水线，实现持续集成与部署 | | 超大日志查看 | 任意大小的文本日志文件秒开，高效定位问题 | | Excalidraw 绘图 | 内置白板绘图工具 | | 多用户管理 | 完善的权限体系 | | 可分享链接 | 生成文件分享链接，方便他人下载 | | 多路径挂载 | 支持挂载多个文件系统路径 |

功能截图

Demo

在线体验地址：http://demo.filecat.xiaobaidadada.fun/

账号密码： demo/demo或者 test/test

Demo 服务器由 野草云 赞助提供

安装方式

小版本 bug 修复与功能更新仅在 npm 上实时发布同步。

1. NPM 安装（推荐）

npm install -g filecat

对于 linux 系统，安装后可以选择使用 pm2 保活，或注册到 systemd保活。

2. Linux 一键脚本

curl -o install.sh https://filecat.xiaobaidadada.fun/files/linux-install.sh && bash install.sh

自动下载二进制包并执行安装，按提示输入参数即可。

3. 二进制包

从 Releases 下载对应系统的最新版本。

4. Docker

docker run -d --name filecat --restart=always --net=host \
  -v /home:/home \
  ghcr.io/xiaobaidadada/filecat:latest \
  --port 5567 --base_folder /home

5. 源码编译

git clone https://github.com/xiaobaidadada/filecat.git
cd filecat
npm install
npm run dev        # 开发模式
# 或
npm run build && node build/main.js  # 生产模式

快速运行

方式一：NPM 安装后执行：

filecat --port 5567

方式二：二进制包解压后，目录内有 filecat-run.sh（Linux/Mac）或 filecat-run.cmd（Windows）运行脚本。

默认账号/密码：admin / admin

更多参数请使用 filecat --help 查看。

权限提示：安装后默认能访问的文件目录是安装目录，请在设置中为每个用户配置可访问目录及执行权限。

升级指南

1. 常规升级：根据你的安装方式升级
   • NPM：npm -g i filecat
   • Docker：重新 pull 最新镜像
   • 二进制：下载最新包替换
2. 自动升级（v5.33.0+）：执行 filecat-upgrade 命令，自动根据安装环境升级。Docker 和二进制安装还支持自定义下载 URL 参数。

社区交流

加入 QQ 群 824838674 进行交流反馈

参与开发

1. PR 请先提交到 dev 分支
2. 功能性提交请在 QQ 群中提前沟通

感谢

以下项目为 FileCat 提供了灵感或基础：

• filebrowser
• MeshCentral
• mstsc