FileCat

项目概述#

FileCat 是一款基于 Node.js（TypeScript/JavaScript）构建并以 Apache-2.0 协议开源的 Web 端服务器综合运维工具，最新版本为 v5.35.2（798+ commits，39 releases）。

传统服务器运维依赖 WinSCP、终端工具、监控面板等碎片化软件，学习成本高且缺乏统一入口；同时 AI 运维落地往往缺乏轻量级、开箱即用的集成方案。FileCat 覆盖从底层文件操作、终端交互、AI 对话执行，到中层 Docker/进程监控，再到上层多协议代理与轻量 CI/CD 的全栈 Web 管理能力。

核心能力#

文件管理与协作#

• 断点分块上传，支持配置多个根目录
• 内置代码编辑器与图片编辑器模式
• 白板绘图、文件分享功能

终端与安全管控#

• 基于 xterm.js 实现的 Web 远程终端
• 虚拟 Shell 层进行命令权限过滤，防止执行 rm -r / 等高危操作

AI 智能运维（AI Agent）#

• 通过自然语言对话执行服务器命令、获取系统资源信息
• AI 执行命令同样受权限过滤机制保护
• 兼容 OpenAI 风格 API
• 支持本地知识库全文检索（RAG）增强 AI 上下文能力

多协议网络代理与组网#

• SSH / HTTP 代理管理多台 Linux 服务器（类似 WinSCP），Windows RDP 远程桌面代理
• 客户端/服务器模式的虚拟 TUN 网络，跨公网/内网分配虚拟 IP 组建局域网
• 服务器控制客户端进行 TCP 通信代理

系统监控与自动化#

• Docker 容器管理、进程监控（注重低 CPU 占用实现）
• 超大日志文件分片读取，实现秒开
• 使用 .act 文件模仿 GitHub workflow 语法的内置 CI/CD 自动化构建
• 多用户权限体系、网站导航书签管理

架构要点#

• 基础框架：基于 Node.js 运行时的单体架构，前端含 xterm.js 终端组件
• 终端安全机制：前端 xterm.js 负责 UI 渲染，后端虚拟 Shell 拦截层通过用户配置的权限白名单放行命令
• AI 集成链路：外挂式接入 OpenAI 兼容 API，结合本地知识库 RAG 全文检索，将检索结果注入 AI Prompt
• 网络层：内置 TUN 虚拟网卡组网能力（客户端/服务端架构）及基于控制通道的 TCP 代理转发
• 大文件处理：采用文件分片读取策略解决超大日志文件的内存占用与前端渲染卡顿
• 设计灵感：文件管理参考 filebrowser，远程控制参考 MeshCentral，RDP 能力参考 mstsc

安装部署#

环境要求：建议 Node.js 20+。若 GitHub 访问慢，需安装 Python 3.8 和 C++ 编译器；Windows 下需 Python 3 + VS Build Tools。

NPM 安装（推荐）

npm install -g filecat

Linux 一键脚本

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

Docker 部署

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

运行与升级

filecat --port 5567
filecat-upgrade    # v5.33.0 起支持自动检测环境升级

默认账号密码：admin/admin

支持 filecat --install 一键注册为 Linux systemd 服务实现保活（兼容 pm2）。终端与 AI 功能需在用户设置中预先配置命令权限和 OpenAI 兼容 API。

待确认事项#

• AI Agent 具体测试过的模型列表未公开
• RAG 知识库的向量数据库选型未明确
• TUN 网络底层依赖（wireguard/自定义）未披露
• 无明确 SLA 或商业支持条款