124 lines
2.7 KiB
Markdown
124 lines
2.7 KiB
Markdown
# 萌芽农场游戏服务器部署指南
|
||
|
||
## 系统要求
|
||
- Python 3.7 或更高版本
|
||
- 稳定的互联网连接
|
||
- 建议：2GB+ 内存，足够的磁盘空间存储玩家数据
|
||
|
||
## 安装步骤
|
||
|
||
### 1. 准备环境
|
||
```bash
|
||
# 在服务器上创建项目文件夹
|
||
mkdir MengYaFarm
|
||
cd MengYaFarm
|
||
|
||
# 克隆或上传服务器代码到此文件夹
|
||
# (手动上传文件或使用Git)
|
||
```
|
||
|
||
### 2. 安装依赖
|
||
```bash
|
||
# 创建虚拟环境(推荐)
|
||
python -m venv venv
|
||
# Linux/Mac激活虚拟环境
|
||
source venv/bin/activate
|
||
# Windows激活虚拟环境
|
||
# venv\Scripts\activate
|
||
|
||
# 安装依赖
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
### 3. 配置服务器
|
||
1. 确保已创建所需文件夹:
|
||
```bash
|
||
mkdir -p game_saves config
|
||
```
|
||
|
||
2. 创建初始玩家数据模板 (如果尚未存在):
|
||
```bash
|
||
# 在config目录中创建initial_player_data_template.json
|
||
```
|
||
|
||
3. 检查 TCPGameServer.py 中的服务器地址和端口配置:
|
||
```python
|
||
server_host: str = "0.0.0.0" # 使用0.0.0.0允许所有网络接口访问
|
||
server_port: int = 9000 # 确保此端口在防火墙中开放
|
||
```
|
||
|
||
4. 如需使用QQ邮箱验证功能，请在QQEmailSend.py中更新发件邮箱配置:
|
||
```python
|
||
SENDER_EMAIL = 'your_qq_number@qq.com' # 发件人邮箱
|
||
SENDER_AUTH_CODE = 'your_auth_code' # 授权码
|
||
```
|
||
|
||
### 4. 启动服务器
|
||
```bash
|
||
# 直接启动
|
||
python Server/TCPGameServer.py
|
||
|
||
# 或使用nohup在后台运行
|
||
nohup python Server/TCPGameServer.py > server.log 2>&1 &
|
||
```
|
||
|
||
### 5. 监控与维护
|
||
- 服务器日志会输出到控制台或server.log
|
||
- 玩家数据存储在game_saves文件夹中
|
||
- 定期备份game_saves文件夹以防数据丢失
|
||
|
||
### 6. 防火墙配置
|
||
确保服务器防火墙允许TCP 9000端口的入站连接:
|
||
|
||
```bash
|
||
# Ubuntu/Debian
|
||
sudo ufw allow 9000/tcp
|
||
|
||
# CentOS/RHEL
|
||
sudo firewall-cmd --permanent --add-port=9000/tcp
|
||
sudo firewall-cmd --reload
|
||
```
|
||
|
||
### 7. 系统服务配置 (可选)
|
||
可以创建systemd服务使服务器自动启动:
|
||
|
||
```bash
|
||
# 创建服务文件
|
||
sudo nano /etc/systemd/system/mengyafarm.service
|
||
|
||
# 添加以下内容
|
||
[Unit]
|
||
Description=MengYa Farm Game Server
|
||
After=network.target
|
||
|
||
[Service]
|
||
Type=simple
|
||
User=your_username
|
||
WorkingDirectory=/path/to/MengYaFarm
|
||
ExecStart=/path/to/MengYaFarm/venv/bin/python /path/to/MengYaFarm/Server/TCPGameServer.py
|
||
Restart=on-failure
|
||
RestartSec=5
|
||
|
||
[Install]
|
||
WantedBy=multi-user.target
|
||
|
||
# 启用并启动服务
|
||
sudo systemctl enable mengyafarm.service
|
||
sudo systemctl start mengyafarm.service
|
||
```
|
||
|
||
## 常见问题
|
||
|
||
### 服务器无法启动
|
||
- 检查Python版本
|
||
- 确认所有依赖已正确安装
|
||
- 检查端口是否被占用
|
||
|
||
### 客户端无法连接
|
||
- 确认服务器IP和端口配置正确
|
||
- 检查防火墙设置
|
||
- 验证网络连接
|
||
|
||
### 发送验证码失败
|
||
- 检查QQ邮箱和授权码设置
|
||
- 确认SMTP服务器可访问 |