c4be264ea5
- Add deployment scripts (deploy.sh, test_connection.sh, core/start_server.sh) - Add deployment documentation (DEPLOYMENT_INFO.md, DEPLOYMENT_SUCCESS.md) - Add .env.example configuration template - Add requirements.txt for Python dependencies - Update README.md with latest information - Update core/server.py with improvements 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
178 lines
3.7 KiB
Markdown
178 lines
3.7 KiB
Markdown
# Funstat MCP 部署信息
|
||
|
||
## 服务器信息
|
||
|
||
- **服务器 IP**: 172.16.74.159
|
||
- **用户**: atai
|
||
- **部署路径**: /home/atai/funstat-mcp
|
||
- **端口**: 8091 (本地监听)
|
||
|
||
## 部署状态
|
||
|
||
✅ **部署成功** - 2025-11-02
|
||
|
||
### 已安装组件
|
||
|
||
- Python 3.12.3
|
||
- 虚拟环境: /home/atai/funstat-mcp/.venv
|
||
- MCP 服务器: v1.20.0
|
||
- Telethon: v1.41.2
|
||
- 代理: v2ray (SOCKS5 on 127.0.0.1:1080)
|
||
|
||
### 配置文件
|
||
|
||
- **环境变量**: /home/atai/funstat-mcp/.env
|
||
- **Session 文件**: ~/telegram_sessions/funstat_bot.session
|
||
- **启动脚本**: /home/atai/funstat-mcp/core/start_server_with_env.sh
|
||
|
||
## 服务管理
|
||
|
||
### 启动服务
|
||
|
||
```bash
|
||
ssh atai@172.16.74.159
|
||
cd /home/atai/funstat-mcp/core
|
||
bash start_server_with_env.sh
|
||
```
|
||
|
||
### 停止服务
|
||
|
||
```bash
|
||
ssh atai@172.16.74.159
|
||
pkill -f 'funstat.*server.py'
|
||
```
|
||
|
||
### 查看日志
|
||
|
||
```bash
|
||
ssh atai@172.16.74.159
|
||
tail -f /tmp/funstat_sse.log
|
||
```
|
||
|
||
### 检查状态
|
||
|
||
```bash
|
||
ssh atai@172.16.74.159
|
||
ps aux | grep python | grep server.py
|
||
netstat -tuln | grep 8091 # 或 ss -tuln | grep 8091
|
||
```
|
||
|
||
## 服务端点
|
||
|
||
- **SSE 端点**: http://172.16.74.159:8091/sse
|
||
- **消息端点**: http://172.16.74.159:8091/messages
|
||
- **内部访问**: http://127.0.0.1:8091/sse
|
||
|
||
✅ 服务监听 0.0.0.0:8091，可从任何网络接口访问。
|
||
|
||
## 环境变量
|
||
|
||
当前配置在 `/home/atai/funstat-mcp/.env`:
|
||
|
||
```bash
|
||
# Telegram API 配置
|
||
TELEGRAM_API_ID=24660516
|
||
TELEGRAM_API_HASH=eae564578880a59c9963916ff1bbbd3a
|
||
TELEGRAM_SESSION_PATH=~/telegram_sessions/funstat_bot
|
||
FUNSTAT_BOT_USERNAME=@openaiw_bot
|
||
|
||
# 代理配置
|
||
FUNSTAT_PROXY_TYPE=socks5
|
||
FUNSTAT_PROXY_HOST=127.0.0.1
|
||
FUNSTAT_PROXY_PORT=1080
|
||
|
||
# 服务器配置
|
||
FUNSTAT_HOST=0.0.0.0
|
||
FUNSTAT_PORT=8091
|
||
```
|
||
|
||
## 重新部署
|
||
|
||
从本地更新代码到服务器：
|
||
|
||
```bash
|
||
cd /Users/hahaha/projects/funstat-mcp
|
||
bash deploy.sh
|
||
```
|
||
|
||
部署脚本会自动：
|
||
1. 打包项目文件
|
||
2. 上传到服务器
|
||
3. 停止旧服务
|
||
4. 解压更新文件
|
||
5. 安装依赖
|
||
|
||
部署后需要手动启动服务：
|
||
|
||
```bash
|
||
ssh atai@172.16.74.159
|
||
cd /home/atai/funstat-mcp/core
|
||
bash start_server_with_env.sh
|
||
```
|
||
|
||
## 故障排除
|
||
|
||
### 1. 服务无法启动
|
||
|
||
检查日志：
|
||
```bash
|
||
tail -50 /tmp/funstat_sse.log
|
||
```
|
||
|
||
### 2. 无法连接 Telegram
|
||
|
||
检查代理是否运行：
|
||
```bash
|
||
ps aux | grep v2ray
|
||
netstat -tuln | grep 1080
|
||
```
|
||
|
||
### 3. Session 文件锁定
|
||
|
||
强制停止并重启：
|
||
```bash
|
||
pkill -9 -f 'funstat.*server.py'
|
||
sleep 2
|
||
cd /home/atai/funstat-mcp/core
|
||
bash start_server_with_env.sh
|
||
```
|
||
|
||
## 运行日志示例
|
||
|
||
成功启动的日志应该包含：
|
||
|
||
```
|
||
✅ 已连接到: KT超级数据
|
||
✅ 当前账号: @xiaobai_80
|
||
🚀 Funstat MCP Server 已启动
|
||
🌐 启动 SSE 服务器: http://127.0.0.1:8091
|
||
Uvicorn running on http://127.0.0.1:8091
|
||
```
|
||
|
||
## 安全注意事项
|
||
|
||
1. ⚠️ .env 文件包含敏感信息，已设置权限保护
|
||
2. ⚠️ Session 文件包含登录凭证，定期备份
|
||
3. ⚠️ 服务监听 0.0.0.0:8091，可从任何网络访问，请注意安全
|
||
4. ⚠️ 服务器需要使用 v2ray 代理访问 Telegram（端口 1080），确保代理服务稳定
|
||
5. ⚠️ 必须使用 start_server_with_env.sh 启动脚本，才能正确加载环境变量和代理配置
|
||
6. ⚠️ 建议在生产环境配置防火墙规则，限制访问来源IP
|
||
|
||
## 更新历史
|
||
|
||
- **2025-11-02**: 初次部署成功
|
||
- 安装所有依赖（包括 PySocks）
|
||
- 配置 v2ray 代理（socks5://127.0.0.1:1080）
|
||
- 创建带环境变量的启动脚本
|
||
- 配置服务监听 0.0.0.0:8091，支持外部访问
|
||
- 服务正常运行
|
||
- ⚠️ 注意：服务器无法直接访问 Telegram，必须使用代理
|
||
- ✅ 可从任何网络通过 http://172.16.74.159:8091 访问
|
||
|
||
## 联系信息
|
||
|
||
- 服务器: 172.16.74.159:22
|
||
- 账号: atai
|
||
- Bot: @openaiw_bot
|
||
- 当前 Telegram 账号: @xiaobai_80
|