使用Nitrado API自动下载服务器日志：解决404错误与最佳实践

import requests
import os

def download_nitrado_logs(server_id, username, password, game_path="games/dayz/log"):
    """
    自动下载Nitrado服务器指定路径下的日志文件。

    Args:
        server_id (str): Nitrado服务器的ID。
        username (str): Nitrado账户的用户名。
        password (str): Nitrado账户的密码。
        game_path (str): 游戏日志在文件服务器上的相对路径，例如 "games/dayz/log"。
                         请根据您的游戏和日志实际路径进行调整。
    """
    base_api_url = f"https://api.nitrado.net/services/{server_id}/gameservers/file_server"
    auth_tuple = (username, password)

    # 1. 列出指定路径下的文件
    list_url = f"{base_api_url}/list"
    # 注意：list端点通常需要一个 'path' 参数来指定要列出的目录
    # 官方文档可能需要将path作为查询参数或请求体发送，这里我们假设为查询参数
    # 实际情况请务必查阅最新的Nitrado API文档

    # 示例中，原始问题是尝试获取dayz的log，这里我们构造一个请求body
    # 实际API调用可能更倾向于POST请求体或GET查询参数
    list_payload = {"path": game_path}
    print(f"尝试从 {list_url} 获取文件列表，路径: {game_path}")

    try:
        # Nitrado API的list端点通常是POST请求，并且path在请求体中
        response = requests.post(list_url, json=list_payload, auth=auth_tuple)
        response.raise_for_status()  # 检查HTTP状态码，如果不是2xx则抛出异常

        file_list_data = response.json()

        # 根据API响应结构，文件列表可能在'data'或直接是列表
        # 这里假设API返回一个包含文件信息的列表
        if not file_list_data or not isinstance(file_list_data, list):
            print(f"警告: 未能获取到有效的文件列表。响应: {response.text}")
            return

        print(f"获取到 {len(file_list_data)} 个文件/目录项。")

        # 过滤出文件，并提取文件名
        log_files = [item['name'] for item in file_list_data if item['type'] == 'file']
        if not log_files:
            print("在指定路径下未找到任何日志文件。")
            return

        print(f"将要下载的日志文件: {', '.join(log_files)}")

        # 2. 下载每个日志文件
        download_base_url = f"{base_api_url}/download"
        download_dir = "downloaded_logs"
        os.makedirs(download_dir, exist_ok=True) # 创建下载目录

        for log_file_name in log_files:
            # 构建完整的日志文件路径，用于下载请求
            full_log_path = os.path.join(game_path, log_file_name).replace("\", "/")
            download_payload = {"path": full_log_path}

            local_file_path = os.path.join(download_dir, log_file_name)

            print(f"尝试下载: {full_log_path} 到 {local_file_path}")
            download_response = requests.post(download_base_url, json=download_payload, auth=auth_tuple, stream=True)

            try:
                download_response.raise_for_status()
                with open(local_file_path, 'wb') as f:
                    for chunk in download_response.iter_content(chunk_size=8192):
                        f.write(chunk)
                print(f"成功下载: {log_file_name}")
            except requests.exceptions.HTTPError as e:
                print(f"下载 {log_file_name} 失败: {e}. 响应内容: {download_response.text}")
            except Exception as e:
                print(f"保存文件 {log_file_name} 时发生错误: {e}")

    except requests.exceptions.HTTPError as e:
        print(f"API请求失败: {e}. 状态码: {response.status_code}. 响应内容: {response.text}")
    except requests.exceptions.ConnectionError as e:
        print(f"网络连接错误: {e}")
    except requests.exceptions.Timeout as e:
        print(f"请求超时: {e}")
    except requests.exceptions.RequestException as e:
        print(f"发生未知请求错误: {e}")
    except Exception as e:
        print(f"脚本执行过程中发生未知错误: {e}")


# 配置您的Nitrado服务器ID、用户名和密码
SERVER_ID = "YOUR_SERVER_ID"  # 替换为您的服务器ID
USERNAME = "YOUR_NITRADO_USERNAME" # 替换为您的Nitrado账户用户名
PASSWORD = "YOUR_NITRADO_PASSWORD" # 替换为您的Nitrado账户密码

if __name__ == "__main__":
    if SERVER_ID == "YOUR_SERVER_ID" or USERNAME == "YOUR_NITRADO_USERNAME" or PASSWORD == "YOUR_NITRADO_PASSWORD":
        print("请在脚本中设置您的Nitrado服务器ID、用户名和密码。")
    else:
        # 调用函数开始下载日志
        # 默认下载DayZ游戏的日志，如果您的游戏不同，请修改 game_path 参数
        download_nitrado_logs(SERVER_ID, USERNAME, PASSWORD, game_path="games/dayz/log")