使用Python和Nitrado API自动下载游戏服务器日志教程

import requests
import os

def download_nitrado_logs(server_id: str, username: str, password: str, log_directory: str = "nitrado_logs"):
    """
    使用Nitrado API自动下载指定服务器的日志文件。

    Args:
        server_id (str): Nitrado服务器的ID。
        username (str): 用于API认证的用户名。
        password (str): 用于API认证的密码。
        log_directory (str): 日志文件下载到的本地目录。
    """
    base_url = f"https://api.nitrado.net/services/{server_id}/gameservers/file_server"
    auth = (username, password)

    # 确保本地日志目录存在
    if not os.path.exists(log_directory):
        os.makedirs(log_directory)
        print(f"Created log directory: {log_directory}")

    # 1. 获取文件列表
    list_url = f"{base_url}/list"
    print(f"Attempting to list files from: {list_url}")
    try:
        response = requests.get(list_url, auth=auth)
        response.raise_for_status() # 检查HTTP错误
        file_list_data = response.json()
    except requests.exceptions.HTTPError as e:
        print(f"Error retrieving file list: {e}")
        print(f"Response content: {response.text}")
        return
    except requests.exceptions.RequestException as e:
        print(f"Network or request error during file list retrieval: {e}")
        return

    # 假设file_list_data是一个包含文件信息的列表，每个元素有'path'字段
    # 实际返回结构请参考Nitrado API文档
    log_files_to_download = []
    print("Available files on server:")
    for item in file_list_data:
        # 筛选出我们感兴趣的日志文件，例如DayZ服务器的日志
        # 请根据实际API返回的路径结构调整筛选逻辑
        if 'path' in item and item['path'].startswith('/games/dayz/log/') and item['path'].endswith('.log'):
            log_files_to_download.append(item['path'])
            print(f"  - {item['path']}")

    if not log_files_to_download:
        print("No DayZ log files found to download.")
        return

    # 2. 下载每个日志文件
    download_base_url = f"{base_url}/download"
    print(f"\nStarting download of {len(log_files_to_download)} log files...")

    for log_file_path in log_files_to_download:
        # 从完整路径中提取文件名作为本地保存的文件名
        local_filename = os.path.join(log_directory, os.path.basename(log_file_path))

        # 构造下载URL，通常通过查询参数指定文件路径
        download_url_with_path = f"{download_base_url}?path={log_file_path}"

        print(f"Downloading {log_file_path} to {local_filename}...")
        try:
            response = requests.get(download_url_with_path, auth=auth, stream=True) # 使用stream=True处理大文件
            response.raise_for_status()

            with open(local_filename, 'wb') as f:
                for chunk in response.iter_content(chunk_size=8192):
                    f.write(chunk)
            print(f"Successfully downloaded: {log_file_path}")
        except requests.exceptions.HTTPError as e:
            print(f"Error downloading {log_file_path}: {e}")
            print(f"Response content: {response.text}")
        except requests.exceptions.RequestException as e:
            print(f"Network or request error during download of {log_file_path}: {e}")

# 设置你的Nitrado服务器ID、用户名和密码
SERVER_ID = "YOUR_SERVER_ID"  # 替换为你的服务器ID
USERNAME = "YOUR_USERNAME"    # 替换为你的Nitrado账户用户名
PASSWORD = "YOUR_PASSWORD"    # 替换为你的Nitrado账户密码

# 调用函数下载日志
if __name__ == "__main__":
    download_nitrado_logs(SERVER_ID, USERNAME, PASSWORD)