322 lines
6.3 KiB
Markdown
322 lines
6.3 KiB
Markdown
# Session 文件管理指南
|
||
|
||
## 📁 Session 文件新位置
|
||
|
||
为了防止 session 文件被意外删除或与其他项目冲突，我们将 session 文件存储在独立的目录中：
|
||
|
||
```
|
||
~/telegram_sessions/funstat_bot.session
|
||
```
|
||
|
||
**完整路径**：
|
||
```
|
||
/Users/lucas/telegram_sessions/funstat_bot.session
|
||
```
|
||
|
||
---
|
||
|
||
## ✅ 为什么要这样做？
|
||
|
||
### 问题
|
||
- ❌ 项目目录可能被清理或删除
|
||
- ❌ 多个项目可能使用相同的 session 名称导致冲突
|
||
- ❌ Session 文件权限可能被意外修改
|
||
|
||
### 解决方案
|
||
- ✅ 独立的 `~/telegram_sessions/` 目录
|
||
- ✅ 不会被项目清理影响
|
||
- ✅ 统一管理所有 Telegram session
|
||
- ✅ 更安全的权限管理
|
||
|
||
---
|
||
|
||
## 🔐 当前 Session 状态
|
||
|
||
### Session 文件位置
|
||
|
||
```bash
|
||
# 主 session（推荐使用）
|
||
~/telegram_sessions/funstat_bot.session
|
||
|
||
# 备份位置（保留）
|
||
/Users/lucas/chat--1003255561049/funstat_bot_session.session
|
||
/Users/lucas/chat--1003255561049/funstat_mcp/funstat_bot_session.session
|
||
```
|
||
|
||
### 检查 Session 状态
|
||
|
||
```bash
|
||
# 查看主 session
|
||
ls -l ~/telegram_sessions/funstat_bot.session
|
||
|
||
# 应该看到：
|
||
# -rw------- 1 lucas staff 28672 ... funstat_bot.session
|
||
# ^^^ 注意这里：600 权限（只有你能读写）
|
||
```
|
||
|
||
### 验证 Session 有效性
|
||
|
||
```bash
|
||
# 检查文件类型
|
||
file ~/telegram_sessions/funstat_bot.session
|
||
|
||
# 应该显示：
|
||
# SQLite 3.x database
|
||
```
|
||
|
||
---
|
||
|
||
## 🔄 Session 管理操作
|
||
|
||
### 创建新 Session
|
||
|
||
如果需要创建新的 session：
|
||
|
||
```bash
|
||
# 1. 进入项目目录
|
||
cd /Users/lucas/chat--1003255561049
|
||
|
||
# 2. 运行创建脚本（会自动保存到新位置）
|
||
python3 create_session_safe.py
|
||
|
||
# 3. 验证
|
||
ls -l ~/telegram_sessions/
|
||
```
|
||
|
||
### 备份 Session
|
||
|
||
```bash
|
||
# 备份到安全位置
|
||
cp ~/telegram_sessions/funstat_bot.session ~/telegram_sessions/funstat_bot.session.backup.$(date +%Y%m%d)
|
||
|
||
# 验证备份
|
||
ls -l ~/telegram_sessions/
|
||
```
|
||
|
||
### 恢复 Session
|
||
|
||
```bash
|
||
# 从备份恢复
|
||
cp ~/telegram_sessions/funstat_bot.session.backup.YYYYMMDD ~/telegram_sessions/funstat_bot.session
|
||
|
||
# 设置正确权限
|
||
chmod 600 ~/telegram_sessions/funstat_bot.session
|
||
```
|
||
|
||
### 删除 Session（重新登录）
|
||
|
||
```bash
|
||
# 删除现有 session
|
||
rm ~/telegram_sessions/funstat_bot.session
|
||
|
||
# 重新创建
|
||
cd /Users/lucas/chat--1003255561049
|
||
python3 create_session_safe.py
|
||
```
|
||
|
||
---
|
||
|
||
## 🔧 故障排除
|
||
|
||
### 问题 1：Session 文件不存在
|
||
|
||
**症状**：
|
||
```
|
||
FileNotFoundError: Session 文件不存在
|
||
```
|
||
|
||
**解决方案**：
|
||
|
||
```bash
|
||
# 方法 1：从旧位置复制
|
||
cp /Users/lucas/chat--1003255561049/funstat_bot_session.session ~/telegram_sessions/funstat_bot.session
|
||
chmod 600 ~/telegram_sessions/funstat_bot.session
|
||
|
||
# 方法 2：重新创建
|
||
cd /Users/lucas/chat--1003255561049
|
||
python3 create_session_safe.py
|
||
```
|
||
|
||
### 问题 2：权限错误
|
||
|
||
**症状**：
|
||
```
|
||
PermissionError: Permission denied
|
||
```
|
||
|
||
**解决方案**：
|
||
|
||
```bash
|
||
# 设置正确权限
|
||
chmod 600 ~/telegram_sessions/funstat_bot.session
|
||
|
||
# 验证
|
||
ls -l ~/telegram_sessions/funstat_bot.session
|
||
# 应该显示: -rw-------
|
||
```
|
||
|
||
### 问题 3：Session 损坏
|
||
|
||
**症状**：
|
||
```
|
||
sqlite3.DatabaseError: file is not a database
|
||
```
|
||
|
||
**解决方案**：
|
||
|
||
```bash
|
||
# 1. 检查文件
|
||
file ~/telegram_sessions/funstat_bot.session
|
||
|
||
# 2. 如果不是 SQLite 数据库，删除并重新创建
|
||
rm ~/telegram_sessions/funstat_bot.session
|
||
cd /Users/lucas/chat--1003255561049
|
||
python3 create_session_safe.py
|
||
```
|
||
|
||
---
|
||
|
||
## 📊 Session 文件信息
|
||
|
||
### 文件结构
|
||
|
||
Session 文件是一个 SQLite 数据库，包含：
|
||
|
||
- ✅ 授权密钥
|
||
- ✅ 服务器信息
|
||
- ✅ 账号信息
|
||
- ✅ 会话状态
|
||
|
||
### 安全建议
|
||
|
||
1. **权限设置**：
|
||
```bash
|
||
chmod 600 ~/telegram_sessions/funstat_bot.session
|
||
```
|
||
|
||
2. **定期备份**：
|
||
```bash
|
||
# 每月备份一次
|
||
cp ~/telegram_sessions/funstat_bot.session ~/telegram_sessions/backup_$(date +%Y%m).session
|
||
```
|
||
|
||
3. **不要分享**：
|
||
- ❌ 不要上传到 Git
|
||
- ❌ 不要通过邮件发送
|
||
- ❌ 不要分享给他人
|
||
|
||
4. **定期更换**：
|
||
- 建议每 3-6 个月重新创建一次
|
||
|
||
---
|
||
|
||
## 🗂️ 目录结构
|
||
|
||
```
|
||
~/telegram_sessions/
|
||
├── funstat_bot.session # 主 session
|
||
├── funstat_bot.session.backup.* # 备份（如果有）
|
||
└── .gitignore # 防止意外提交（推荐创建）
|
||
```
|
||
|
||
### 创建 .gitignore
|
||
|
||
```bash
|
||
# 防止意外提交到 Git
|
||
echo "*.session" > ~/telegram_sessions/.gitignore
|
||
echo "*.session-journal" >> ~/telegram_sessions/.gitignore
|
||
```
|
||
|
||
---
|
||
|
||
## 🔄 迁移旧 Session
|
||
|
||
如果你有旧的 session 文件需要迁移：
|
||
|
||
```bash
|
||
# 1. 创建目录（如果不存在）
|
||
mkdir -p ~/telegram_sessions
|
||
|
||
# 2. 复制旧 session
|
||
cp /path/to/old/session.session ~/telegram_sessions/funstat_bot.session
|
||
|
||
# 3. 设置权限
|
||
chmod 600 ~/telegram_sessions/funstat_bot.session
|
||
|
||
# 4. 验证
|
||
ls -l ~/telegram_sessions/
|
||
file ~/telegram_sessions/funstat_bot.session
|
||
|
||
# 5. 测试
|
||
cd /Users/lucas/chat--1003255561049/funstat_mcp
|
||
python3 test_server.py
|
||
```
|
||
|
||
---
|
||
|
||
## 📝 自动化脚本
|
||
|
||
### 每日检查脚本
|
||
|
||
创建一个脚本来检查 session 健康状态：
|
||
|
||
```bash
|
||
#!/bin/bash
|
||
# ~/telegram_sessions/check_session.sh
|
||
|
||
SESSION_FILE=~/telegram_sessions/funstat_bot.session
|
||
|
||
if [ ! -f "$SESSION_FILE" ]; then
|
||
echo "❌ Session 文件不存在"
|
||
exit 1
|
||
fi
|
||
|
||
PERMS=$(stat -f "%OLp" "$SESSION_FILE")
|
||
if [ "$PERMS" != "600" ]; then
|
||
echo "⚠️ 权限不正确: $PERMS (应该是 600)"
|
||
chmod 600 "$SESSION_FILE"
|
||
echo "✅ 已修复权限"
|
||
fi
|
||
|
||
if file "$SESSION_FILE" | grep -q "SQLite"; then
|
||
echo "✅ Session 文件正常"
|
||
else
|
||
echo "❌ Session 文件损坏"
|
||
exit 1
|
||
fi
|
||
```
|
||
|
||
使用：
|
||
|
||
```bash
|
||
chmod +x ~/telegram_sessions/check_session.sh
|
||
~/telegram_sessions/check_session.sh
|
||
```
|
||
|
||
---
|
||
|
||
## 🎯 最佳实践总结
|
||
|
||
1. ✅ **使用独立目录**：`~/telegram_sessions/`
|
||
2. ✅ **设置正确权限**：`chmod 600`
|
||
3. ✅ **定期备份**：每月一次
|
||
4. ✅ **定期更换**：3-6 个月
|
||
5. ✅ **监控健康**：定期检查
|
||
6. ✅ **安全存储**：不要分享或提交到 Git
|
||
|
||
---
|
||
|
||
## 📞 需要帮助？
|
||
|
||
如果遇到 session 相关问题：
|
||
|
||
1. 运行健康检查：`~/telegram_sessions/check_session.sh`
|
||
2. 查看详细文档：`/Users/lucas/chat--1003255561049/funstat_mcp/README.md`
|
||
3. 运行测试脚本：`python3 test_server.py`
|
||
|
||
---
|
||
|
||
**文档版本**: 1.0
|
||
**最后更新**: 2025-10-26
|
||
**维护者**: Funstat MCP Project
|