日志文件位置

本文档描述星空组网应用在不同操作系统上的日志文件存储位置。

日志分类

应用共有两类日志：

GUI 日志 (main.log)

GUI 日志由 Electron 应用程序生成，记录界面程序的运行状态、错误信息等。

macOS

日志目录:

~/Library/Logs/stars.console.electron/

查看日志文件:

ls -la ~/Library/Logs/stars.console.electron/

日志文件:

~/Library/Logs/stars.console.electron/main.log

快速查看日志内容:

cat ~/Library/Logs/stars.console.electron/main.log

实时查看日志:

tail -f ~/Library/Logs/stars.console.electron/main.log

Windows

日志目录:

C:\Users\<用户名>\AppData\Roaming\stars.console.electron\logs\

注意：<用户名> 需替换为实际的 Windows 用户名，例如 Administrator

日志文件:

C:\Users\<用户名>\AppData\Roaming\stars.console.electron\logs\main.log

快速访问:

1. 按 Win + R 打开运行对话框
2. 输入 %APPDATA%\stars.console.electron\logs 并回车

通过命令行查看:

type "%APPDATA%\stars.console.electron\logs\main.log"

主程序日志 (stars.log)

主程序日志由核心服务程序生成，记录 VPN 连接、网络通信等核心功能的运行状态。

macOS

日志目录:

~/Library/Application Support/stars/

日志文件:

~/Library/Application Support/stars/stars.log

快速查看日志内容:

cat ~/Library/Application\ Support/stars/stars.log

实时查看日志:

tail -f ~/Library/Application\ Support/stars/stars.log

Windows

日志目录:

C:\Program Files (x86)\StarVPN\res\

日志文件:

C:\Program Files (x86)\StarVPN\res\stars.log

通过命令行查看:

type "C:\Program Files (x86)\StarVPN\res\stars.log"

注意：由于该目录位于 Program Files 下，查看日志可能需要管理员权限

Linux

日志目录:

/usr/local/lib/stars/res/

日志文件:

/usr/local/lib/stars/res/stars.log

快速查看日志内容:

cat /usr/local/lib/stars/res/stars.log

实时查看日志:

tail -f /usr/local/lib/stars/res/stars.log

注意：查看该目录可能需要 root 权限，可使用 sudo 命令

日志位置汇总表

常见问题排查

如何收集所有日志？

macOS:

# 创建日志收集目录
mkdir -p ~/Desktop/stars-logs

# 复制所有日志
cp ~/Library/Logs/stars.console.electron/main.log ~/Desktop/stars-logs/gui-main.log
cp ~/Library/Application\ Support/stars/stars.log ~/Desktop/stars-logs/core-stars.log

# 打包
cd ~/Desktop && zip -r stars-logs.zip stars-logs/

Windows (PowerShell):

# 创建日志收集目录
New-Item -ItemType Directory -Path "$env:USERPROFILE\Desktop\stars-logs" -Force

# 复制所有日志
Copy-Item "$env:APPDATA\stars.console.electron\logs\main.log" "$env:USERPROFILE\Desktop\stars-logs\gui-main.log"
Copy-Item "C:\Program Files (x86)\StarVPN\res\stars.log" "$env:USERPROFILE\Desktop\stars-logs\core-stars.log"

# 打包
Compress-Archive -Path "$env:USERPROFILE\Desktop\stars-logs" -DestinationPath "$env:USERPROFILE\Desktop\stars-logs.zip"