RustMinerSystem/README.md

# RustMinerSystem (форк)

RustMinerSystem — закрытая по исходникам система управления майнингом криптовалют: прокси традиционных пулов с возможностью брать комиссию («抽水»/отвод хешрейта) и режим собственного пул-ноды, плюс веб-панель управления фермой. Репозиторий разработчика содержит не исходный код, а готовые собранные бинарники под Linux (x86_64, ARM, ARMv7) и Windows, установочные bash-скрипты, картинки и документацию.

Форк сделан как резервная копия репозитория [EvilGenius-dot/RustMinerSystem](https://github.com/EvilGenius-dot/RustMinerSystem) в самохостовом Gitea: проект распространяется только через GitHub, а бинарники и install-скрипты нужны для развёртывания, поэтому важно иметь собственную копию.

Документация оригинала (китайский README версии 4.6.7) сохранена в [README.upstream.md](README.upstream.md); переводы на английский и русский лежат в `Readme/i18n/zh-EN/README.md` и `Readme/i18n/zh-RU/README.md`.

> **Внимание: рабочая копия не выгружена.** Клонирование выполнялось без установленного `git-lfs`, поэтому checkout прервался и в каталоге физически присутствуют только `.gitattributes` и этот README. Все объекты, кроме одного LFS-файла, находятся в `.git` (около 863 МБ) и доступны через `git cat-file -p HEAD:<путь>`. Чтобы получить рабочую копию, установите `git-lfs` и выполните `git lfs install && git checkout -- .`; без LFS-объекта восстановится всё, кроме `APP/PoolNode/Android/PoolNode.apk`.

## Отличия от оригинала

Изменений нет. В репозитории один коммит — `4.6.7` от 23.03.2026, автор `evilgenius <evilgenius1999@proton.me>` (разработчик оригинала, история сжата в один снимок). Собственных правок владельца форка нет. Форк взят как резервная копия.

## Стек

- Основная программа — готовые бинарники `rustminersystem-<версия>` (Linux) и `.exe` (Windows). Исходников в репозитории нет, язык из кода не определяется; название и `.gitattributes` (`*.sh linguist-language=Rust`) указывают на Rust, но это лишь маркер подсветки на GitHub.
- Установка и обслуживание — Bash + systemd (служба `rustservice`), `wget`/`curl` для загрузки бинарников.
- Веб-панель встроена в бинарник (HTTP или HTTPS на настраиваемом порту).
- Мобильное приложение PoolNode для Android поставляется APK-файлом через Git LFS.
- Лицензия MIT, Copyright (c) 2023 RustMinerSystem.

## Структура

Пути даны по `git ls-tree -r HEAD` — в рабочем каталоге их пока нет.

| Путь | Назначение |
|---|---|
| `install.sh` | Основной установщик/менеджер для Linux x86_64: двуязычное (EN/中文) меню на 16+ пунктов — установка, обновление, старт/стоп/рестарт, смена порта, снятие лимита соединений, автозапуск, статус, логи, сброс пароля, установка конкретной версии, удаление |
| `arm-install.sh`, `armv7-install.sh` | То же самое для ARM и ARMv7 |
| `linux/rustminersystem-4.4.6 … 4.6.7` | Бинарники под x86_64, 22 версии, ~17–19 МБ каждая |
| `linux/arm/`, `linux/armv7/` | Бинарники под ARM (4.0.0, 4.5.0, 4.6.0, 4.6.1) и ARMv7 (4.0.0, 4.6.0, 4.6.1) |
| `windows/rustminersystem-*.exe` | Сборки под Windows, те же 22 версии |
| `APP/PoolNode/Android/PoolNode.apk` | Android-приложение PoolNode, ~117 МБ, хранится в Git LFS. В этом клоне присутствует только указатель LFS, сам файл не выгружен |
| `origin.json` | Метаданные релиза: `version 4.6.7`, `PoolNodeAndroidVersion 1.0.1`, `PoolNodeIosVersion 1.0.1` |
| `README.md` (оригинал), `Readme/i18n/zh-EN/`, `Readme/i18n/zh-RU/` | Документация на китайском, английском и русском |
| `image/` | Около 90 картинок: логотипы, иконки монет (BTC, ETH, ETC, KAS, XMR, RVN, CFX и др.), гифки-демонстрации интерфейса |
| `excel端口导入模板.xlsx` | Шаблон Excel для массового импорта портов |
| `LICENSE` | MIT |

Общий объём репозитория велик именно из-за бинарников всех версий — около 850 МБ в истории.

## Как собрать/запустить

Сборка не предусмотрена: в репозитории только скомпилированные файлы.

Linux (от root), штатный способ из документации оригинала:

```bash
bash <(curl -s -L https://github.com/EvilGenius-dot/RustMinerSystem/raw/main/install.sh)
# ARM
bash <(curl -s -L https://github.com/EvilGenius-dot/RustMinerSystem/raw/main/arm-install.sh)
# ARMv7
bash <(curl -s -L https://github.com/EvilGenius-dot/RustMinerSystem/raw/main/armv7-install.sh)
```

Скрипт скачивает бинарник нужной версии в `/root/rustminersystem/rustminersystem`, регистрирует systemd-службу `rustservice`, включает автозапуск и печатает адрес веб-панели `http(s)://<внешний IP>:<порт>`.

Windows: скачать `windows/rustminersystem-<версия>.exe` и запустить — панель откроется в браузере.

Локально из этого клона нужный файл можно извлечь без выгрузки всей рабочей копии:

```bash
git cat-file -p HEAD:linux/rustminersystem-4.6.7 > rustminersystem && chmod +x rustminersystem
```

## Конфигурация

Настройки лежат в файле `rust-config` в каталоге установки (`/root/rustminersystem/rust-config`), формат `КЛЮЧ=значение`:

| Ключ | Назначение |
|---|---|
| `START_PORT` | Порт веб-панели. При первой установке выбирается случайным, значение по умолчанию в скрипте — 63521 |
| `ENABLE_WEB_TLS` | 0 — панель по HTTP, 1 — по HTTPS |

Прочие пути, задаваемые установщиком: `/root/rustminersystem` (каталог программы), `nohup.out` и `err.log` (логи), `0.d1`, `0.d1-shm`, `0.d1-wal` (файлы БД — их удаление и есть «сброс пароля»).

Учётные данные веб-панели: логин и пароль по умолчанию зашиты в бинарник и печатаются установщиком — см. `README.upstream.md` и вывод `install.sh` (пункт «сброс пароля» возвращает их). В открытый доступ они попали вместе с оригиналом, поэтому после установки их обязательно нужно сменить в веб-интерфейсе вместе с портом. В этот README значения не переносятся.

Отдельно отметить: `install.sh` при установке отключает firewalld/ufw и выставляет `chmod 777` на каталог программы и её файлы — с точки зрения безопасности сервера это агрессивное поведение.

## Состояние

Рабочий продукт стороннего разработчика, актуальная на момент снимка версия 4.6.7. Один коммит, дата — 23.03.2026. Собственных коммитов владельца форка нет.

Отдельно: сам клон неполный — рабочая копия не выгружена, LFS-объект `PoolNode.apk` (116 954 884 байта, sha256 `c58f9044…cea75`) отсутствует. Для полноценной резервной копии нужно доставить LFS-объект с оригинала.

## Что не доделано

Оценить недоделки по коду невозможно: исходников в репозитории нет, есть только бинарники, скрипты и документация. Меток TODO/FIXME в bash-скриптах не найдено. Незакрытый вопрос по самому форку — отсутствующий LFS-объект APK и невыгруженная рабочая копия (см. выше).