FileCat

一款自部署的 Web 文件服务器与轻量级服务器管理工具

功能特性 • 功能截图 • 安装方式 • 快速运行

English

---

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

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

---

功能特性

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

---

功能截图

文件列表	AI Agent
内网穿透	系统信息看板

---

Demo

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

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

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

---

安装方式

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

1. NPM 安装（推荐）

npm install -g filecat

对于 Linux 系统，安装后可以选择使用 pm2 保活，或执行 filecat --install 注册到 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

---

Made with love by xiaobaidadada