Nitrado服务器日志自动下载：解决API 404错误与正确实践

import requests
import os
import json # 导入json库用于处理请求体

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

    Args:
        server_id (str): Nitrado服务器的ID。
        username (str): 用于API认证的用户名。
        password (str): 用于API认证的密码。
        game_path (str): 服务器上日志文件所在的相对路径，例如 "games/dayz/log"。
    """
    base_url = f"https://api.nitrado.net/services/{server_id}/gameservers/file_server"
    auth = (username, password)

    # 1. 获取日志文件列表
    list_url = f"{base_url}/list"
    list_payload = {"path": game_path} # POST请求体

    print(f"尝试获取路径 '{game_path}' 下的文件列表...")
    try:
        response = requests.post(list_url, auth=auth, json=list_payload)
        response.raise_for_status() # 检查HTTP响应状态码，如果不是2xx则抛出异常

        file_list_data = response.json()

        # 提取文件名称，通常API会返回一个包含文件和目录信息的列表
        # 假设文件列表在 'data' 键下，每个文件有 'name' 键
        # 实际结构请参考API文档
        log_files = [item['name'] for item in file_list_data.get('data', []) if item.get('type') == 'file']

        if not log_files:
            print(f"路径 '{game_path}' 下未找到任何日志文件或API响应结构不符合预期。")
            print(f"API响应: {file_list_data}")
            return

        print(f"找到 {len(log_files)} 个日志文件: {', '.join(log_files)}")

        # 2. 逐一下载每个日志文件
        download_url = f"{base_url}/download"
        download_count = 0
        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}

            print(f"尝试下载: {full_log_path}...")
            try:
                download_response = requests.post(download_url, auth=auth, json=download_payload)
                download_response.raise_for_status() # 检查HTTP响应状态码

                # 保存文件
                with open(log_file_name, 'wb') as file:
                    file.write(download_response.content)
                print(f"成功下载: {log_file_name}")
                download_count += 1
            except requests.exceptions.RequestException as e:
                print(f"下载 {full_log_path} 时发生错误: {e}")
                if download_response.status_code == 404:
                    print(f"文件 {full_log_path} 可能不存在或路径错误。")
                elif download_response.status_code == 401:
                    print("认证失败，请检查用户名和密码。")
            except Exception as e:
                print(f"保存文件 {log_file_name} 时发生未知错误: {e}")

        print(f"下载完成。共成功下载 {download_count} 个文件。")

    except requests.exceptions.RequestException as e:
        print(f"获取文件列表时发生网络或API错误: {e}")
        if response.status_code == 401:
            print("认证失败，请检查用户名和密码。")
        elif response.status_code == 404:
            print("文件列表端点可能不存在或服务器ID错误。")
        print(f"错误响应: {response.text}")
    except json.JSONDecodeError:
        print(f"API响应不是有效的JSON格式。原始响应: {response.text}")
    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__":
    download_nitrado_logs(SERVER_ID, USERNAME, PASSWORD)