umbrix/update-server/INSTALL_INSTRUCTIONS.md

🚀 Инструкция по установке Gitea на сервер 85.208.139.84

Шаг 1: Подключение к серверу

# Подключитесь к серверу по SSH
ssh root@85.208.139.84
# или
ssh ваш_пользователь@85.208.139.84

Шаг 2: Загрузка установочного скрипта

Вариант A: Через scp (с локальной машины)

cd ~/dorod/hiddify-umbrix-v1.7.0/update-server
scp install-gitea.sh root@85.208.139.84:/root/

Вариант B: Прямо на сервере (создать файл)

# На сервере
nano install-gitea.sh
# Скопируйте содержимое файла install-gitea.sh
# Сохраните: Ctrl+O, Enter, Ctrl+X

Вариант C: Через curl (самый простой)

# На сервере, скопируйте файл в интернет и скачайте:
curl -O https://ваш-сервер/install-gitea.sh

Шаг 3: Запуск установки

# Сделайте скрипт исполняемым
chmod +x install-gitea.sh

# Запустите установку
sudo ./install-gitea.sh

Установка займёт 3-5 минут.

Шаг 4: Первоначальная настройка Gitea

1. Откройте браузер: http://85.208.139.84:3000

2. При первом входе увидите страницу установки:

   Database Settings:

   • Database Type: PostgreSQL ✓
   • Host: db:5432 ✓
   • Username: gitea ✓
   • Password: gitea_secure_pass_2026 ✓
   • Database Name: gitea ✓

   General Settings:

   • Site Title: Umbrix Updates
   • Repository Root Path: /data/git/repositories ✓
   • Git LFS Root Path: /data/git/lfs ✓
   • Run As Username: git ✓

   Server and Third-Party Service Settings:

   • SSH Server Domain: 85.208.139.84 ✓
   • SSH Server Port: 2222 ✓
   • Gitea HTTP Listen Port: 3000 ✓
   • Gitea Base URL: http://85.208.139.84:3000 ✓

   Email Settings: (можно пропустить)

   Administrator Account Settings:

   • Administrator Username: admin (или ваш логин)
   • Password: (ваш надёжный пароль)
   • Email: admin@umbrix.net

3. Нажмите "Install Gitea"

4. Дождитесь завершения установки (10-20 секунд)

5. Войдите с созданными учётными данными

Шаг 5: Создание репозитория Umbrix

1. После входа нажмите "+" → "New Repository"

2. Заполните:

   • Owner: admin (ваш пользователь)
   • Repository Name: umbrix
   • Description: Umbrix VPN Application
   • Visibility: ☑ Public (важно для updates!)
   • Initialize Repository: ☐ (пустой, заполним с локальной машины)

3. Нажмите "Create Repository"

Шаг 6: Загрузка кода с локальной машины

# На локальной машине
cd ~/dorod/hiddify-umbrix-v1.7.0

# Добавьте remote для Gitea
git remote add gitea http://85.208.139.84:3000/admin/umbrix.git

# Запушьте код
git push -u gitea main
# Введите: admin / ваш_пароль

Шаг 7: Создание первого релиза

Через UI:

1. Откройте: http://85.208.139.84:3000/admin/umbrix

2. Перейдите: Releases → New Release

3. Заполните:

   • Tag version: v1.7.3
   • Release Title: Umbrix v1.7.3
   • Describe this release:

     ## 🚀 Что нового
     - Улучшена стабильность подключения
     - Исправлены ошибки
     

4. Прикрепите файлы (Drag & Drop):

   • dist/umbrix-1.7.3-linux.deb
   • dist/umbrix-1.7.3-linux.rpm
   • dist/Umbrix-1.7.3-linux.AppImage

5. Нажмите "Publish Release"

Через API (автоматизация):

# Получите Access Token
# Gitea → Settings → Applications → Generate New Token
# Permissions: read:repository, write:repository

TOKEN="ваш_токен"

# Создайте релиз
curl -X POST "http://85.208.139.84:3000/api/v1/repos/admin/umbrix/releases" \
  -H "Authorization: token $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "tag_name": "v1.7.3",
    "name": "Umbrix v1.7.3",
    "body": "## Что нового\n- Улучшена стабильность",
    "draft": false,
    "prerelease": false
  }'

# Загрузите файлы
RELEASE_ID=1  # ID из предыдущего ответа

curl -X POST "http://85.208.139.84:3000/api/v1/repos/admin/umbrix/releases/$RELEASE_ID/assets" \
  -H "Authorization: token $TOKEN" \
  -H "Content-Type: multipart/form-data" \
  -F "attachment=@dist/umbrix-1.7.3-linux.deb"

Шаг 8: Настройка Umbrix для использования Gitea

Отредактируйте lib/core/model/constants.dart:

abstract class Constants {
  static const appName = "Umbrix";
  static const githubUrl = "http://85.208.139.84:3000/admin/umbrix";
  static const githubReleasesApiUrl = "http://85.208.139.84:3000/api/v1/repos/admin/umbrix/releases";
  static const githubLatestReleaseUrl = "http://85.208.139.84:3000/admin/umbrix/releases/latest";
  // ...
  static const useCustomUpdateServer = false; // Используем Gitea API
}

Пересоберите:

flutter build linux --release

Шаг 9: Тест проверки обновлений

1. Запустите пересобранное приложение
2. Откройте: Настройки → О программе
3. Нажмите "Проверка обновлений"
4. Должно показать: "Доступно обновление до версии 1.7.3"

📊 Управление сервером

# На сервере
cd /opt/gitea

# Просмотр логов
docker-compose logs -f gitea

# Статус контейнеров
docker-compose ps

# Перезапуск
docker-compose restart

# Остановка
docker-compose down

# Запуск
docker-compose up -d

# Обновление Gitea
docker-compose pull
docker-compose up -d

🔧 Устранение проблем

Gitea не запускается

docker-compose logs gitea
docker-compose logs db

Порты заняты

# Проверьте что порты свободны
netstat -tulpn | grep 3000
netstat -tulpn | grep 2222

Забыли пароль админа

docker exec -it gitea gitea admin user change-password -u admin -p новый_пароль

🌐 Следующие шаги (опционально)

1. Настройка домена (вместо IP)

Если есть домен git.umbrix.net:

1. Добавьте A-запись: git.umbrix.net → 85.208.139.84
2. Установите Nginx + Certbot для HTTPS
3. Обновите GITEA__server__DOMAIN в docker-compose.yml

2. Автоматизация сборки

Настройте Gitea Actions (аналог GitHub Actions) для автоматической сборки при push.

3. Зеркала

Разверните такие же контейнеры на других IP для обхода блокировок.

✅ Готово!

Теперь у вас работает:

• ✓ Gitea на http://85.208.139.84:3000
• ✓ API обновлений: http://85.208.139.84:3000/api/v1/repos/admin/umbrix/releases
• ✓ Umbrix проверяет обновления через Gitea