# FTP管理器 **Repository Path**: dawnice/ftp-manager ## Basic Information - **Project Name**: FTP管理器 - **Description**: FTP管理器(vsftp),基于Web的多代理集中管控型的系统,适用于基于虚拟用户的vsftp服务的快捷管理。 - **Primary Language**: Unknown - **License**: MulanPSL-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2026-03-09 - **Last Updated**: 2026-05-11 ## Categories & Tags **Categories**: Uncategorized **Tags**: FTP, vsftp, FTP管理 ## README # FTP 管理器 一个用于管理多台 FTP 服务器的 Web 管理系统,支持远程用户管理、权限控制、系统监控等功能。 ## 项目简介 FTP 管理器采用**中心化管理架构**,由 Web 管理端统一管理多台 FTP Agent 服务器。管理员可以通过 Web 界面远程管理各服务器上的 FTP 虚拟用户、权限和系统配置。 ### 主要功能 - **多服务器管理**: 一键添加、删除、监控多台 FTP 服务器 - **用户管理**: 创建、修改、删除 FTP 虚拟用户 - **权限控制**: 细粒度的目录权限管理(读取/上传/创建/删除) - **系统监控**: 实时监控服务器 CPU、内存、磁盘使用情况 - **安全认证**: 基于 Cookie 的会话管理,支持验证码 - **角色管理**: 管理员(operator)/操作员(operator)/查看者(viewer) 三级权限 ## 目录结构 ``` ftp-manager/ ├── agent/ # FTP Agent - 部署在被管理的 FTP 服务器上 │ ├── main.go # Agent 主入口 │ ├── users_handler.go # 用户管理 API │ ├── system_monitor.go # 系统监控 │ ├── config_handler.go # 配置管理 │ └── README.md # Agent 详细文档 │ ├── client/ # Web 管理端 - 管理员操作的 Web 界面 │ ├── backend/ # Go 后端服务 (Gin + GORM + SQLite) │ │ ├── main.go # 后端主入口 │ │ ├── config/ # 配置管理 │ │ ├── models/ # 数据模型 │ │ ├── routes/ # API 路由 │ │ ├── services/ # 业务逻辑 │ │ └── utils/ # 工具函数 │ ├── frontend/ # Vue 3 前端 (Element Plus + Pinia) │ │ ├── src/ # 源代码 │ │ ├── package.json # 依赖配置 │ │ └── vite.config.ts # Vite 配置 │ ├── config/ # 配置文件目录 │ ├── data/ # 数据库目录 │ └── README.md # Client 详细文档 │ ├── deploy/ # 部署工具 - 跨平台编译和安装 │ ├── main.go # 部署工具主入口 │ ├── build.go # 编译逻辑 │ ├── installer.go # 安装/卸载 │ ├── service.go # 服务管理 │ ├── build-release.sh # 一键编译脚本 │ ├── DEPLOYMENT_PLAN.md # 部署方案设计 │ ├── DEPLOYMENT_GUIDE.md # 详细部署指南 │ ├── DEPLOYMENT_EXAMPLES.md # 使用示例 │ └── README.md # Deploy 详细文档 │ ├── LICENSE # Mulan PSL v2 许可证 └── README.md # 本文件 ``` ## 系统架构 ``` ┌─────────────────────────────────────────────────────────────────────┐ │ Web 管理端 (Client) │ │ ┌─────────────────┐ ┌──────────────────┐ │ │ │  Vue 3 前端  │◄─────►│ │ │ │ │  (端口3000)  │ │ │ │ │ └──────┬──────────┘ │  SQLite 数据库  │ │ │ │ ↑托管   │ ftp-manager.db │ │ │ ┌──────┴─────────┐ │ │ │ │ │   Go 后端   │◄──────►│ │ │ │ │ (端口3000)  │ └──────────────────┘ │ │ └──────┬─────────┘ │ └───────────────────┼─────────────────────────────────────────────────┘ │ HTTP API (X-API-Key) ┌─────────┴─────────────┬───────────────────────┐ │ │ │ ▼ ▼ ▼ ┌──────────────┐     ┌──────────────┐     ┌──────────────┐ │  Agent 1  │     │  Agent 2  │     │  Agent N.. │ │ (FTP服务器) │     │ (FTP服务器) │     │ (FTP服务器) │ │  端口8080   │     │  端口8080   │     │  端口8080  │ └──────────────┘     └──────────────┘     └──────────────┘ ``` ## 快速开始 ### 环境要求 | 组件 | 版本要求 | 用途 | |------|---------|------| | Go | 1.21+ | 后端服务 | | Node.js | 16+ | 前端构建 | | npm/yarn | 最新版 | 前端依赖管理 | ### 开发环境启动 ```bash # 1. 克隆项目 git clone https://gitee.com/your-username/ftp-manager.git cd ftp-manager # 2. 启动 Web 管理端开发环境 cd client ./start-dev.sh # 3. 访问 Web 界面 # http://localhost:5173 # 默认账户: admin / admin123 ``` ### 编译发布版本 ```bash # 进入部署工具目录 cd deploy # 编译所有平台 ./build-release.sh all # 或单独编译 ./build-release.sh linux # Linux 版本 ./build-release.sh windows # Windows 版本 # 发布文件位于 deploy/release/ 目录 ``` ### 安装部署 详细安装步骤请参考 [deploy/README.md](./deploy/README.md) #### Linux 安装 ```bash cd deploy/release/linux chmod +x ftp-manager-web sudo ./ftp-manager-web -install # 访问 http://服务器IP:5173 ``` #### Windows 安装 ```cmd cd deploy\release\windows .\ftp-manager-web.exe -install REM 以管理员身份运行 ``` ## 各模块说明 ### Agent - FTP Agent 服务 部署在每台需要管理的 FTP 服务器上,提供: - FTP 虚拟用户管理 (vsftpd) - 权限控制 - 系统监控(CPU、内存、磁盘) - 配置管理 详细文档: [agent/README.md](./agent/README.md) ### Client - Web 管理端 管理员使用的 Web 界面,提供: - 多服务器集中管理 - 用户 CRUD 操作 - 权限分配 - 系统监控面板 - 登录认证 详细文档: [client/README.md](./client/README.md) ### Deploy - 部署工具 跨平台编译和安装工具,提供: - 一键编译 Linux/Windows 版本 - 系统服务自动配置 - 安装/卸载命令 - 桌面快捷方式生成 详细文档: [deploy/README.md](./deploy/README.md) ## 技术栈 ### 后端 - **框架**: Gin (Go Web Framework) - **ORM**: GORM - **数据库**: SQLite - **认证**: Cookie Session + bcrypt ### 前端 - **框架**: Vue 3 - **UI库**: Element Plus - **状态管理**: Pinia - **构建工具**: Vite - **代码编辑器**: Monaco Editor ## 开发指南 ### 添加新的 API 端点 1. 在 `client/backend/models/` 添加数据模型 2. 在 `client/backend/routes/` 添加路由处理 3. 在 `client/backend/services/` 添加业务逻辑 4. 在 `client/frontend/src/services/` 添加前端 API 调用 ### 添加新的 FTP Agent 功能 1. 在 `agent/` 目录添加新的处理函数 2. 在 `main.go` 中注册路由 3. 更新 `agent/README.md` ### 修改部署配置 1. 编辑 `deploy/build.go` 修改编译配置 2. 编辑 `deploy/installer.go` 修改安装逻辑 3. 编辑 `deploy/service.go` 修改服务管理 ## 注意事项 1. **生产环境安全**: - 修改默认管理员密码 - 配置防火墙规则 - 启用 HTTPS 2. **Agent 通信**: - 确保 Client 能访问 Agent 的 8080 端口 - API Key 需要保密 3. **数据库备份**: - 定期备份 `client/data/ftp-manager.db` - 建议使用自动备份脚本 ## 许可证 本项目采用 Mulan Permissive Software License v2 (Mulan PSL v2) 许可证。 详见 [LICENSE](./LICENSE) 文件。 ## 作者 Dawnice Tam ( dawnice@yandex.com ) ## 更新日志 ### v1.0.0 (2026-04-25) - 初始版本发布 - 支持多服务器管理 - 支持 FTP 虚拟用户管理 - 支持系统监控 - 支持跨平台部署