📢 项目简介

FinalShellDecoderX 是一款专为 FinalShell 用户设计的配置解析工具，能够自动检测 FinalShell 安装目录，解析所有服务器连接配置，并解密保存的密码与私钥。该工具支持跨平台使用（macOS / Windows / Linux），提供 GUI 图形界面与命令行两种使用方式，让你轻松管理和迁移 FinalShell 连接配置。

项目地址: https://github.com/XLevon/FinalshellDecoderX

✨ 核心功能

🎯 配置解析与凭据解密

• 自动检测: 智能识别 FinalShell 安装目录，无需手动查找
• 批量解析: 一次性解析所有服务器连接配置
• 凭据解密: 自动解密加密保存的密码与 SSH 私钥
• 完整性验证: 确保解析结果的准确性和完整性

🖥️ 界面与交互

• GUI 版本: 直观的表格界面展示所有连接信息
• 表格排序: 支持点击列标题排序（名称、主机、端口等）
• 快捷操作: 右键菜单快速复制凭据或查看详情
• 水平滚动: 支持长内容完整显示
• 详细信息: 双击查看服务器完整配置与密钥信息

📁 输出与导出

• 凭据复制: 双击自动复制登录凭据到剪贴板
• 私钥导出: 命令行版本支持将私钥导出到文件
• 自定义路径: 支持自定义私钥保存路径
• 批量/单个: 灵活选择导出全部或特定私钥

🛠️ 安装方法

方式一：使用 uv（推荐）

uv venv
uv add pyperclip pycryptodome

方式二：标准 venv

python3 -m venv venv
source venv/bin/activate      # macOS / Linux
# venv\Scripts\activate       # Windows

pip install pyperclip pycryptodome

方式三：直接安装

pip install pyperclip pycryptodome

🚀 使用教程

GUI 版本使用

1. 启动工具

# uv 方式
uv run python final_shell_decoder.py

# 标准方式
python final_shell_decoder.py

2. 自动检测

   • 程序启动后自动检测 FinalShell 安装目录
   • 检测成功后显示路径信息
   • 若未检测到，点击「手动选择」浏览目录

3. 开始解析

   • 点击「开始解析」按钮
   • 等待解析完成，所有连接配置将显示在表格中

4. 查看与使用

   • 双击任意行查看详情，凭据自动复制到剪贴板
   • 点击列标题可按该列排序
   • 右键菜单提供复制凭据和查看详情功能

命令行版本使用

1. 基本用法

# 自动检测目录
python final_shell_decoder_cli.py

# 指定目录
python final_shell_decoder_cli.py /path/to/finalshell

2. 查看帮助

python final_shell_decoder_cli.py --help
python final_shell_decoder_cli.py --version

3. 导出私钥
   • 解析完成后，程序会提示是否导出私钥
   • 默认保存到 output/ 目录
   • 支持选择导出全部或特定私钥

🔐 技术原理

密码解密流程

1. Base64 解码加密密码字段
2. 提取前 8 字节作为头部（head）信息
3. 通过 ranDomKey(head) 生成 DES 密钥
4. 使用 DES-ECB 模式解密剩余字节，得到明文密码

私钥解密流程

1. 从 config.json 的 secret_key_list 中提取 key_data
2. Base64 解码 key_data，得到原始 OpenSSH 私钥
3. 匹配私钥 ID 与服务器配置，完成私钥关联

⚠️ 安全提示

1. 合法使用：仅用于个人数据备份、安全审计、自用环境迁移
2. 避免泄露：解析后的凭据和私钥请妥善保管
3. 目录保护：不要将 config.json、conn/、output/ 目录提交到版本控制系统
4. 风险自负：请在授权环境中使用，使用者需自行承担使用风险

📁 项目结构

├── final_shell_decoder.py       # GUI 版本
├── final_shell_decoder_cli.py   # 命令行版本
├── src/
│   ├── __init__.py
│   └── core.py                  # 共享核心库（解密引擎、JSON 解析、数据模型）
├── tests/
│   └── test_core.py             # 单元测试
├── pyproject.toml               # 项目配置
└── README.md                    # 项目说明

🤝 贡献与反馈

欢迎大家对项目提出建议和反馈，你可以通过以下方式参与贡献：

1. 提交 Issue 报告 Bug 或提出新功能建议
2. 提交 Pull Request 贡献代码
3. 分享使用经验和优化建议

📝 免责声明

本项目仅供学习交流使用，不隶属于 FinalShell 官方，仅用于对本地配置文件进行解析与展示。请勿向 FinalShell 官方反馈任何问题，请勿在 FinalShell 官方社区提及此工具。使用者需自行承担使用风险。

---

FinalShellDecoderX —— 让 FinalShell 配置管理更简单、更高效！

如果觉得项目有用，请给个 ⭐ 支持一下吧！