From e4fc3fce692688ef4c91dfd953b3925883a11e13 Mon Sep 17 00:00:00 2001 From: karpenok Date: Wed, 11 Nov 2026 23:39:18 +0700 Subject: [PATCH] =?UTF-8?q?fix(remnawave):=20=D0=BF=D0=BE=D0=BB=D1=8C?= =?UTF-8?q?=D0=B7=D0=BE=D0=B2=D0=B0=D1=82=D0=B5=D0=BB=D0=B8=20=D0=B8=D0=B7?= =?UTF-8?q?=20=D1=84=D0=B0=D0=B9=D0=BB=D0=B0,=20=D1=80=D0=BE=D1=82=D0=B0?= =?UTF-8?q?=D1=86=D0=B8=D1=8F=20API-=D1=82=D0=BE=D0=BA=D0=B5=D0=BD=D0=B0?= =?UTF-8?q?=20=D0=B1=D0=B5=D0=B7=20=D0=BB=D0=BE=D0=B3=D0=BE=D0=B2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit users.yml — источник правды (homelab — первый). Именованный токен перевыпускается каждый прогон и пишется в Infisical; stdout/stderr секретов в CI закрыты no_log и redact. Co-authored-by: Cursor --- BOOTSTRAP.md | 4 +- .../roles/core-net/remnawave/files/users.yml | 12 ++ .../roles/core-net/remnawave/tasks/main.yml | 22 +-- .../remnawave/templates/bootstrap-panel.sh.j2 | 149 ++++++++++++++---- 4 files changed, 146 insertions(+), 41 deletions(-) create mode 100644 ansible/roles/core-net/remnawave/files/users.yml diff --git a/BOOTSTRAP.md b/BOOTSTRAP.md index cf6a5fc..c4d159c 100644 --- a/BOOTSTRAP.md +++ b/BOOTSTRAP.md @@ -149,11 +149,11 @@ API Endpoint (внутренний LAN): `http://192.168.1.102:8080/api` - `/ci-cd` → `CLOUDFLARE_API` - `/VPS` → `PASS_GER_NOD_02` (пароль нового VPS) 2. Запустить **`ansible-core-net`** (полный прогон или `--tags remnawave` после того, как Traefik уже с роутами `rw`/`sub`). -3. Роль поднимает `/opt/remnawave` (panel+db+redis) и `/opt/remnawave/subscription`, создаёт `REMNAWAVE_ADMIN_*`, API-токен `infra-automation`, config profile **`DE-Yali`**, ноду **`Ger-nod-02`**, host **`yali.gunis.top`**, пишет токен и `REMNANODE_SECRET_KEY` в Infisical. +3. Роль поднимает `/opt/remnawave` (panel+db+redis) и `/opt/remnawave/subscription`, создаёт `REMNAWAVE_ADMIN_*`, каждый прогон **перевыпускает** API-токен `infra-automation` и кладёт его в Infisical (старый сразу недействителен). Config profile **`DE-Yali`**, сквад `Default-Squad` на inbound Steal-Yali, нода **`Ger-nod-02`**, host **`yali.gunis.top`**. Пользователи — файл `ansible/roles/core-net/remnawave/files/users.yml` (добавление/изменение/удаление = правка файла). 4. Проверить `https://rw.gunihome.ru` и `https://sub.gunihome.ru`. > [!IMPORTANT] -> **Логи и новые установки Remnawave:** задача bootstrap всегда с `no_log: true`. В stderr скрипта ответы API с `privateKey` / `SECRET_KEY` / JWT / API-токеном редáctятся (`[REDACTED]`). При отладке **не** снимать `no_log` и не `printf` сырой JSON keygen/x25519/tokens в CI — иначе Reality-ключи и токены утекут в Gitea Actions. Admin JWT к API v3 требует заголовок `X-Remnawave-Client-Type: browser`; постоянная автоматизация — только через `REMNAWAVE_API_TOKEN` (scopes `*`). +> **Логи:** bootstrap, запись секретов в Infisical и `.env` — всегда `no_log: true`. stderr API редактит `privateKey` / `SECRET_KEY` / JWT / API-токен / `shortUuid` / пароли клиентов. Не снимать `no_log` и не печатать сырой JSON keygen/tokens. Значение токена не пишется в лог даже при ошибке Infisical. ### Шаг 4b. Remnawave Node ger-nod-02 (SelfSteal) 1. После успешного `ansible-core-net` (чтобы в Infisical был `REMNANODE_SECRET_KEY`) запустить **`ansible-ger-nod-02`**. diff --git a/ansible/roles/core-net/remnawave/files/users.yml b/ansible/roles/core-net/remnawave/files/users.yml new file mode 100644 index 0000000..25f4155 --- /dev/null +++ b/ansible/roles/core-net/remnawave/files/users.yml @@ -0,0 +1,12 @@ +# Источник правды для пользователей Remnawave. +# Добавление — новая запись. Изменение — правка полей. Удаление — убрать запись. +# Пользователь, которого нет в списке, удаляется при следующем прогоне ansible-core-net. +# Пароли/UUID клиент генерирует панель; в файл их не класть. +users: + - username: homelab + status: ACTIVE + expire_at: "2099-01-01T00:00:00.000Z" + description: homelab + traffic_limit_bytes: 0 + traffic_limit_strategy: NO_RESET + squad: Default-Squad diff --git a/ansible/roles/core-net/remnawave/tasks/main.yml b/ansible/roles/core-net/remnawave/tasks/main.yml index facf195..04f1bc5 100644 --- a/ansible/roles/core-net/remnawave/tasks/main.yml +++ b/ansible/roles/core-net/remnawave/tasks/main.yml @@ -170,6 +170,14 @@ delay: 5 until: remnawave_auth_status.rc == 0 +- name: Записать список пользователей + ansible.builtin.copy: + dest: "{{ remnawave_dir }}/users.json" + content: "{{ lookup('file', 'users.yml') | from_yaml | to_json }}" + owner: root + group: root + mode: "0600" + - name: Инициализировать админа, API-токен, профиль DE-Yali, ноду и хост ansible.builtin.shell: | set -euo pipefail @@ -193,6 +201,7 @@ RW_HOST_REMARK: "{{ remnawave_host_remark }}" RW_PROFILE_FILE: "{{ remnawave_dir }}/profile-de-yali.json" RW_PANEL_DOMAIN: "{{ remnawave_panel_domain }}" + RW_USERS_FILE: "{{ remnawave_dir }}/users.json" register: remnawave_bootstrap_raw changed_when: false failed_when: remnawave_bootstrap_raw.rc != 0 @@ -222,7 +231,7 @@ - name: Сохранить API-токен и SECRET_KEY ноды в Infisical ansible.builtin.shell: | set -euo pipefail - out=$(infisical secrets set \ + infisical secrets set \ --domain="${INFISICAL_DOMAIN}" \ --token="${INFISICAL_TOKEN}" \ --env=prod \ @@ -230,10 +239,7 @@ --path="/services/remnawave" \ "REMNAWAVE_API_TOKEN=${RW_API_TOKEN}" \ "REMNANODE_SECRET_KEY=${RW_NODE_SECRET}" \ - --silent 2>&1) || { - echo "infisical secrets set failed: ${out}" >&2 - exit 1 - } + --silent >/dev/null args: executable: /bin/bash delegate_to: localhost @@ -244,9 +250,7 @@ INFISICAL_PROJECT_ID: "{{ lookup('env', 'INFISICAL_PROJECT_ID') }}" RW_API_TOKEN: "{{ remnawave_api_token }}" RW_NODE_SECRET: "{{ remnawave_bootstrap.node_secret | default(lookup('env', 'REMNANODE_SECRET_KEY', default='')) }}" - when: >- - remnawave_bootstrap.token_updated | default(false) - or remnawave_need_node_secret + when: remnawave_api_token | default('') | length > 0 changed_when: true no_log: true @@ -268,7 +272,7 @@ mode: "0644" - name: Запустить subscription-page - ansible.builtin.command: docker compose -f {{ remnawave_subscription_dir }}/compose.yaml up -d --remove-orphans + ansible.builtin.command: docker compose -f {{ remnawave_subscription_dir }}/compose.yaml up -d --force-recreate --remove-orphans register: remnawave_sub_up changed_when: >- 'Started' in remnawave_sub_up.stderr or diff --git a/ansible/roles/core-net/remnawave/templates/bootstrap-panel.sh.j2 b/ansible/roles/core-net/remnawave/templates/bootstrap-panel.sh.j2 index 581ae85..fcb7cb8 100644 --- a/ansible/roles/core-net/remnawave/templates/bootstrap-panel.sh.j2 +++ b/ansible/roles/core-net/remnawave/templates/bootstrap-panel.sh.j2 @@ -20,7 +20,7 @@ redact_json() { jq 'walk( if type == "object" then with_entries( - if (.key | test("(?i)privateKey|privKey|secretKey|SECRET_KEY|accessToken|apiToken|password|^token$")) + if (.key | test("(?i)privateKey|privKey|secretKey|SECRET_KEY|accessToken|apiToken|password|^token$|vlessUuid|trojanPassword|ssPassword|shortUuid|subscriptionUrl")) then .value = "[REDACTED]" else . end @@ -87,36 +87,37 @@ else AUTH_HDR=(-H "Authorization: Bearer ${access}") fi -# Постоянный API-токен: scopes ["*"] (wildcard из GET /tokens/scopes). -# Если создать нельзя — не валим bootstrap; пользователь может положить токен вручную. -if [ -z "${active_token}" ] || [ "${admin_created}" -eq 1 ]; then - tokens_json=$(api GET /tokens/ || echo '{"response":[]}') - old_uuid=$(printf '%s' "${tokens_json}" | jq -r --arg n "$RW_TOKEN_NAME" ' - (.response // .) - | if type=="array" then . elif .tokens then .tokens else [] end - | map(select(.name == $n or .tokenName == $n)) - | .[0].uuid // empty') - if [ -n "${old_uuid}" ]; then - api DELETE "/tokens/${old_uuid}" >/dev/null || true - fi - - wildcard=$(api GET /tokens/scopes 2>/dev/null | jq -r '.response.wildcard // "*"') - token_payload=$(jq -n --arg n "$RW_TOKEN_NAME" --arg s "${wildcard:-*}" \ - '{name: $n, expiresInDays: 3650, scopes: [$s]}') - if token_resp=$(api POST /tokens/ -d "${token_payload}"); then - created=$(printf '%s' "${token_resp}" | jq -r ' - .response.token // .response.apiToken // .token // .apiToken // empty') - if [ -n "${created}" ]; then - active_token="${created}" - token_updated=1 - else - echo "WARN: POST /tokens/ без поля token — положите REMNAWAVE_API_TOKEN вручную" >&2 - printf \'%s -\' "${token_resp}" | redact_json >&2 - fi +# Каждый прогон перевыпускает именованный API-токен и гасит предыдущие +# (в том числе утёкший). Само значение наружу не печатаем. +tokens_json=$(api GET /tokens/ || echo '{"response":[]}') +old_uuids=$(printf '%s' "${tokens_json}" | jq -r --arg n "$RW_TOKEN_NAME" ' + (.response // .) + | if type=="array" then . elif .tokens then .tokens else [] end + | map(select(.name == $n or .tokenName == $n) | .uuid) + | .[]') +for old_uuid in ${old_uuids}; do + [ -n "${old_uuid}" ] || continue + api DELETE "/tokens/${old_uuid}" >/dev/null || true +done +active_token="" +wildcard=$(api GET /tokens/scopes 2>/dev/null | jq -r '.response.wildcard // "*"') +token_payload=$(jq -n --arg n "$RW_TOKEN_NAME" --arg s "${wildcard:-*}" \ + '{name: $n, expiresInDays: 3650, scopes: [$s]}') +if token_resp=$(api POST /tokens/ -d "${token_payload}"); then + created=$(printf '%s' "${token_resp}" | jq -r ' + .response.token // .response.apiToken // .token // .apiToken // empty') + if [ -n "${created}" ]; then + active_token="${created}" + token_updated=1 else - echo "WARN: не удалось создать API-токен автоматически — создайте в UI и положите в Infisical /services/remnawave как REMNAWAVE_API_TOKEN" >&2 + echo "WARN: POST /tokens/ без поля token" >&2 fi +else + echo "WARN: не удалось перевыпустить API-токен" >&2 +fi +if [ -z "${active_token}" ]; then + echo "Нет нового API-токена — bootstrap остановлен, секрет в лог не пишем" >&2 + exit 1 fi # SECRET_KEY ноды — отдельный endpoint /api/keygen/ (не ответ create node) @@ -286,6 +287,92 @@ if [ -z "${host_uuid}" ]; then host_created=1 fi +users_changed=0 +squad_uuid=$(api GET /internal-squads/ | jq -r --arg n "Default-Squad" ' + .response.internalSquads[]? | select(.name == $n) | .uuid' | head -1) +if [ -n "${squad_uuid}" ] && [ -n "${inbound_uuid}" ]; then + has_inbound=$(api GET /internal-squads/ | jq -r --arg s "${squad_uuid}" --arg i "${inbound_uuid}" ' + .response.internalSquads[]? | select(.uuid == $s) | .inbounds[]?.uuid | select(. == $i)' | head -1) + if [ -z "${has_inbound}" ]; then + squad_body=$(jq -n --arg u "${squad_uuid}" --arg i "${inbound_uuid}" '{uuid: $u, inbounds: [$i]}') + api PATCH /internal-squads/ -d "${squad_body}" >/dev/null + users_changed=1 + fi +fi + +# Конфиг страницы подписки: дефолт с config=null страница не поднимает. +sub_cfgs=$(api GET /subscription-page-configs/ || echo '{"response":{"configs":[]}}') +ready=$(printf '%s' "${sub_cfgs}" | jq '[.response.configs[]? | select(.config != null)] | length') +if [ "${ready}" = "0" ]; then + api POST /subscription-page-configs/ -d '{"name":"Homelab"}' >/dev/null + users_changed=1 +fi + +# Браузер: Accept и User-Agent без учёта регистра, правило BROWSER первым. +settings=$(api GET /subscription-settings/ || echo '') +if [ -n "${settings}" ]; then + patched=$(printf '%s' "${settings}" | jq ' + .response + | .responseRules.rules = ( + [ + { + name: "Browser", + enabled: true, + operator: "OR", + description: "IaC: HTML-страница подписки", + responseType: "BROWSER", + conditions: [ + {headerName: "accept", operator: "CONTAINS", value: "text/html", caseSensitive: false}, + {headerName: "user-agent", operator: "CONTAINS", value: "Mozilla", caseSensitive: false} + ] + } + ] + [ + .responseRules.rules[]? + | select(.name != "Browser" and .name != "Browser Subscription" and .responseType != "BROWSER") + ] + )') + api PATCH /subscription-settings/ -d "${patched}" >/dev/null \ + || api PUT /subscription-settings/ -d "${patched}" >/dev/null \ + || echo "WARN: не удалось обновить SRR" >&2 +fi + +if [ -n "${RW_USERS_FILE:-}" ] && [ -f "${RW_USERS_FILE}" ]; then + existing=$(api GET "/users/?size=500" || api GET /users/) + desired_names=$(jq -r '.users[].username' "${RW_USERS_FILE}") + while IFS= read -r username; do + [ -n "${username}" ] || continue + want=$(jq -c --arg u "${username}" '.users[] | select(.username == $u)' "${RW_USERS_FILE}") + squad_name=$(printf '%s' "${want}" | jq -r '.squad // "Default-Squad"') + sid=$(api GET /internal-squads/ | jq -r --arg n "${squad_name}" '.response.internalSquads[]? | select(.name == $n) | .uuid' | head -1) + uuid=$(printf '%s' "${existing}" | jq -r --arg u "${username}" '.response.users[]? | select(.username == $u) | .uuid' | head -1) + body=$(printf '%s' "${want}" | jq -c --arg sid "${sid}" '{ + username, + status: (.status // "ACTIVE"), + expireAt: .expire_at, + description: (.description // ""), + trafficLimitBytes: (.traffic_limit_bytes // 0), + trafficLimitStrategy: (.traffic_limit_strategy // "NO_RESET"), + activeInternalSquads: (if $sid == "" then [] else [$sid] end) + }') + if [ -z "${uuid}" ]; then + api POST /users/ -d "${body}" >/dev/null + users_changed=1 + else + api PATCH /users/ -d "$(printf '%s' "${body}" | jq -c --arg id "${uuid}" '. + {uuid: $id}')" >/dev/null + users_changed=1 + fi + done <<< "${desired_names}" + while IFS= read -r row; do + [ -n "${row}" ] || continue + uname=${row%% *} + uuuid=${row#* } + if ! printf '%s\n' "${desired_names}" | grep -qx "${uname}"; then + api DELETE "/users/${uuuid}" >/dev/null + users_changed=1 + fi + done < <(printf '%s' "${existing}" | jq -r '.response.users[]? | "\(.username)\t\(.uuid)"') +fi + jq -n \ --arg api_token "${active_token}" \ --arg node_secret "${node_secret}" \ @@ -298,6 +385,7 @@ jq -n \ --argjson profile_created "${profile_created}" \ --argjson node_created "${node_created}" \ --argjson host_created "${host_created}" \ + --argjson users_changed "${users_changed}" \ '{ api_token: $api_token, node_secret: $node_secret, @@ -310,5 +398,6 @@ jq -n \ profile_created: ($profile_created == 1), node_created: ($node_created == 1), host_created: ($host_created == 1), - changed: (($admin_created + $token_updated + $profile_created + $node_created + $host_created) > 0) + users_changed: ($users_changed == 1), + changed: (($admin_created + $token_updated + $profile_created + $node_created + $host_created + $users_changed) > 0) }'