# bt-beanstalkd

**Repository Path**: matrixonline/bt-beanstalkd

## Basic Information

- **Project Name**: bt-beanstalkd
- **Description**: 宝塔Beanstalkd服务管理插件
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-03
- **Last Updated**: 2026-08-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Beanstalkd 管理器 - 宝塔面板插件

宝塔面板管理 Beanstalkd 消息队列服务的插件，提供可视化的服务管理界面。

## 功能特性

### 服务管理
- 一键安装 / 卸载 Beanstalkd
- 启动 / 停止 / 重启服务
- 开机自启开关
- 实时服务状态监控（版本、PID、连接数、运行时长、监听地址）

### 监控统计
- 服务器级统计（总 Job 数、Ready/Buried/Delayed/Reserved/Urgent 数量）
- 每个 Tube 的独立统计详情
- 连接数监控

### 配置管理
- 监听地址 / 端口配置
- 运行用户设置
- 最大 Job 大小限制
- Binlog 持久化配置
- 详细日志开关
- 0.0.0.0 监听安全警告提示

### 日志查看
- 系统日志文件查看（/var/log 相关）
- journalctl 日志获取

## 安装方式

### 方法一：宝塔面板导入
1. 将整个 `beanstalkd_manager` 目录打包为 ZIP
2. 登录宝塔面板 → 软件商店 → 第三方应用
3. 点击「导入插件」，选择 ZIP 文件
4. 安装完成后即可在软件商店找到

### 方法二：手动安装
```bash
# 下载插件文件到宝塔插件目录
cp -r beanstalkd_manager /www/server/panel/plugin/
cd /www/server/panel/plugin/beanstalkd_manager
chmod +x install.sh
bash install.sh install
```

## 文件结构

```
beanstalkd_manager/
├── info.json                      # 插件元数据
├── beanstalkd_manager_main.py     # 后端主程序（Python）
├── index.html                     # 前端管理界面
├── install.sh                     # 安装脚本
├── uninstall.sh                   # 卸载脚本
├── icon.png                       # 插件图标
├── package.sh                     # 打包脚本
└── README.md                      # 说明文档
```

## 系统要求

- 宝塔面板 >= 6.8
- CentOS 7/8、Rocky Linux、AlmaLinux、Ubuntu 18.04+、Debian 9+
- Python 2.7+ 或 Python 3.x
- EPEL 仓库（CentOS 系列需要）

## 使用说明

### 首次使用
1. 安装插件后，进入插件页面
2. 点击「一键安装 Beanstalkd」按钮（自动检测系统并安装）
3. 安装完成后服务会自动配置
4. 点击「启动」按钮启动服务

### 日常管理
- **查看状态**：进入插件首页即可看到服务运行状态
- **管理 Tube**：在 Tube 管理区域查看各个 Tube 的统计信息
- **修改配置**：在配置管理区域修改后保存，重启服务生效
- **查看日志**：在日志区域查看服务运行日志

## 后端 API 接口

| 方法名 | 说明 | 参数 |
|--------|------|------|
| `get_service_status` | 获取服务状态（含 boot_enabled） | - |
| `start_service` | 启动服务 | - |
| `stop_service` | 停止服务 | - |
| `restart_service` | 重启服务 | - |
| `set_boot_status` | 设置开机自启 | `enable` (0/1) |
| `install_beanstalkd` | 安装 Beanstalkd | - |
| `uninstall_beanstalkd` | 卸载 Beanstalkd | - |
| `get_config` | 获取配置 | - |
| `save_config` | 保存配置 | `address`, `port`, `user`, `max_job_size`, `binlog_dir`, `verbose` |
| `get_server_stats` | 获取服务器统计 | - |
| `list_tubes` | 列出所有 Tube | - |
| `get_all_tube_details` | 获取所有 Tube 详细统计 | - |
| `get_logs` | 获取日志 | - |

## 注意事项

1. **持久化**：如需 Beanstalkd 重启后恢复 Job，请在配置中设置 Binlog 目录
2. **防火墙**：Beanstalkd 默认端口 11300，如需远程访问请开放防火墙
3. **安全**：Beanstalkd 默认无认证机制，建议仅监听内网地址。插件会在设置为 0.0.0.0 时给出安全警告
4. **配置生效**：修改配置后必须重启服务才能生效

## 技术实现

- **后端**：Python，通过 TCP 直连 Beanstalkd telnet 协议交互
- **前端**：jQuery + 宝塔面板内置样式，统一 Loading 和错误处理
- **通信**：前端通过 POST 请求调用后端方法
- **服务管理**：通过 systemctl 管理 Beanstalkd 服务
- **兼容性**：兼容宝塔面板 7.x / 8.x / 9.x 版本

## 许可证

MIT License