游魂（EtherGhost）开源项目使用与配置教程

游魂（EtherGhost）开源项目使用与配置教程

EtherGhost 新一代Webshell管理器，兼容蚁剑与冰蝎的PHP webshell 项目地址: https://gitcode.com/gh_mirrors/et/EtherGhost

1. 项目目录结构及介绍

游魂（EtherGhost）项目的目录结构如下：

EtherGhost/
├── .github/
├── .gitattributes
├── .gitignore
├── LICENSE
├── README.md
├── README_en.md
├── build.sh
├── docs.md
├── flake.lock
├── flake.nix
├── poetry.lock
├── psudo_shell.py
├── pyinstaller_package.bat
├── pyproject.toml
├── requirements.txt
├── run_ether_ghost.py
├── assets/
├── ether_ghost/
│   ├── frontend/
│   ├── test_environment/
└── ...

• .github/: 存放 GitHub 专用的配置文件和模板。
• .gitattributes: 定义如何对待特定文件的 Git 属性。
• .gitignore: 定义哪些文件和目录应该被 Git 忽略。
• LICENSE: 项目使用的开源许可证文件。
• README.md 和 README_en.md: 项目说明文件的中文和英文版本。
• build.sh: 用于构建项目的脚本文件。
• docs.md: 存放项目文档的 Markdown 文件。
• flake.lock 和 flake.nix: 使用 flakes 管理依赖关系的锁定文件。
• poetry.lock: 使用 Poetry 包管理工具的锁定文件。
• psudo_shell.py: 伪壳脚本文件。
• pyinstaller_package.bat: 使用 PyInstaller 打包项目为可执行文件的批处理脚本。
• pyproject.toml: 定义项目 metadata 和依赖关系的配置文件。
• requirements.txt: 定义项目依赖的 Python 包。
• run_ether_ghost.py: 启动游魂项目的 Python 脚本。
• assets/: 存放项目所需的静态资源文件，如图片、样式表等。
• ether_ghost/: 存放游魂项目的核心代码。
  • frontend/: 前端代码目录。
  • test_environment/: 测试环境目录。

2. 项目的启动文件介绍

项目的启动文件是 run_ether_ghost.py。该文件负责初始化和启动游魂项目的核心功能。运行以下命令可以启动项目：

python run_ether_ghost.py

在 Windows 系统下，可以使用以下命令：

.\run_ether_ghost.py

或者如果你已经创建了一个虚拟环境，可以激活虚拟环境后运行：

.\.venv\Scripts\activate
python run_ether_ghost.py

启动后，项目将运行在本地开发服务器上，通常是通过本地浏览器进行连接。

3. 项目的配置文件介绍

游魂项目的配置主要通过 pyproject.toml 和 requirements.txt 文件进行管理。

• pyproject.toml: 该文件定义了项目的 metadata，包括项目名称、版本、作者、依赖关系等。例如：

[tool.poetry]
name = "ether-ghost"
version = "0.1.0"
description = "新一代Webshell管理器，兼容蚁剑与冰蝎的PHP webshell"
authors = ["Marven11"]

[tool.poetry.dependencies]
python = "^3.8"

[tool.poetry.dev-dependencies]
pytest = "^6.2"

• requirements.txt: 该文件列出了项目运行所需的所有 Python 包及其版本。例如：

Flask==2.0.1
requests==2.25.1
pycryptodome==3.10.1

确保在运行项目之前，所有依赖都已正确安装。可以通过以下命令安装：

pip install -r requirements.txt

或者在 Windows 系统下，使用以下命令：

.\.venv\Scripts\activate
pip install -r requirements.txt

以上是游魂开源项目的目录结构、启动文件及配置文件的简要介绍。在实际使用中，请根据项目需求和文档进行详细配置。

EtherGhost 新一代Webshell管理器，兼容蚁剑与冰蝎的PHP webshell 项目地址: https://gitcode.com/gh_mirrors/et/EtherGhost