refactor(opnsense/xray): replace 310-line Jinja loop with sync_xray.py
ansible-deploy / plan (push) Successful in 1s
ansible-lint / lint (push) Successful in 3s
ansible-deploy / deploy (opnsense, ) (push) Successful in 3s

This commit is contained in:
karpenok committed 2026-11-15 23:07:41 +07:00
1 parent ae9beee5ca
commit aab0611aaf
4 files changed
+245 -289

No files matched your search

+34 -282
View File
@@ -1,6 +1,6 @@
---
# Синхронизация подписок Xray на OPNsense с файлом instances.yml.
# Управление через API плагина os-xray (/api/xray/...), как в роли opnsense/netbird.
# Логика сравнения, валидации, testconnect и отката — в files/sync_xray.py.
- name: Проверить обязательные секреты OPNsense
ansible.builtin.assert:
@@ -13,298 +13,50 @@
ansible.builtin.set_fact:
xray_wanted: "{{ lookup('file', role_path ~ '/files/instances.yml') | from_yaml }}"
- name: Проверить, что активна ровно одна подписка
ansible.builtin.assert:
that:
- (xray_wanted.instances | selectattr('active') | list | length) == 1
fail_msg: "В instances.yml должна быть ровно одна подписка с active: true."
- name: Подготовить окружение с VLESS-ссылками подписок
ansible.builtin.set_fact:
xray_sync_env:
OPNSENSE_API_KEY: "{{ opnsense_api_key }}"
OPNSENSE_API_SECRET: "{{ opnsense_api_secret }}"
no_log: true
- name: Сконвертировать ссылки в outbound_config
ansible.builtin.command: python3 {{ role_path }}/files/vless_to_outbound.py
args:
stdin: "{{ lookup('env', item.secret, default='') }}"
register: xray_conv
- name: Добавить секреты подписок в окружение sync_xray.py
ansible.builtin.set_fact:
xray_sync_env: "{{ xray_sync_env | combine({item.secret: lookup('env', item.secret, default='')}) }}"
loop: "{{ xray_wanted.instances }}"
loop_control:
label: "{{ item.name }}"
changed_when: false
no_log: true
- name: Проверить наличие ссылок и конвертацию
ansible.builtin.assert:
that:
- item.1.rc == 0
fail_msg: >-
Подписка {{ item.0.name }}: нет ссылки в Infisical /services/opnsense-xray
(ключ {{ item.0.secret }}) или она не конвертируется. Проверьте секрет и формат vless://.
loop: "{{ xray_wanted.instances | zip(xray_conv.results) | list }}"
loop_control:
label: "{{ item.0.name }}"
no_log: true
- name: Сформировать желаемое состояние
ansible.builtin.set_fact:
xray_desired: "{{ xray_desired | default([]) + [ { 'name': item.0.name, 'active': item.0.active | bool, 'outbound': item.1.stdout } ] }}"
loop: "{{ xray_wanted.instances | zip(xray_conv.results) | list }}"
loop_control:
label: "{{ item.0.name }}"
no_log: true
- name: Получить текущие инстансы из OPNsense
ansible.builtin.uri:
url: "https://{{ opnsense_host }}/api/xray/instance/searchItem"
method: GET
url_username: "{{ opnsense_api_key }}"
url_password: "{{ opnsense_api_secret }}"
force_basic_auth: true
validate_certs: false
status_code: [200]
register: xray_current
- name: Отобрать лишние инстансы (нет в instances.yml)
ansible.builtin.set_fact:
xray_stale: "{{ xray_current.json.rows | default([]) | rejectattr('name', 'in', xray_desired | map(attribute='name') | list) | list }}"
- name: Отметить текущую активную подписку (для отката)
ansible.builtin.set_fact:
xray_prev_active: "{{ xray_current.json.rows | default([]) | selectattr('enabled', 'equalto', '1') | map(attribute='name') | list }}"
- name: Отключить лишние активные инстансы
ansible.builtin.uri:
url: "https://{{ opnsense_host }}/api/xray/instance/toggleItem/{{ item.uuid }}/0"
method: POST
url_username: "{{ opnsense_api_key }}"
url_password: "{{ opnsense_api_secret }}"
force_basic_auth: true
validate_certs: false
body_format: json
body: {}
status_code: [200]
loop: "{{ xray_stale | selectattr('enabled', 'equalto', '1') | list }}"
loop_control:
label: "{{ item.name }}"
register: xray_toggle_stale
changed_when: true
- name: Прочитать полные поля существующих инстансов
ansible.builtin.uri:
url: "https://{{ opnsense_host }}/api/xray/instance/getItem/{{ item.uuid }}"
method: GET
url_username: "{{ opnsense_api_key }}"
url_password: "{{ opnsense_api_secret }}"
force_basic_auth: true
validate_certs: false
status_code: [200]
loop: "{{ xray_current.json.rows | default([]) | selectattr('name', 'in', xray_desired | map(attribute='name') | list) | list }}"
loop_control:
label: "{{ item.name }}"
register: xray_existing
- name: Сформировать payload инстансов
ansible.builtin.set_fact:
xray_payloads: "{{ xray_payloads | default({}) | combine({ item.name: { 'enabled': '1' if item.active else '0', 'name': item.name, 'outbound_config': item.outbound, 'socks5_listen': xray_socks5_listen, 'socks5_port': xray_socks5_port, 'tun_interface': xray_tun_interface, 'mtu': xray_mtu, 'bypass_networks': xray_bypass_networks, 'loglevel': xray_loglevel } }) }}"
loop: "{{ xray_desired }}"
loop_control:
label: "{{ item.name }}"
no_log: true
- name: Добавить новые подписки
ansible.builtin.uri:
url: "https://{{ opnsense_host }}/api/xray/instance/addItem"
method: POST
url_username: "{{ opnsense_api_key }}"
url_password: "{{ opnsense_api_secret }}"
force_basic_auth: true
validate_certs: false
body_format: json
body:
instance: "{{ xray_payloads[item.name] }}"
status_code: [200]
loop: "{{ xray_desired | rejectattr('name', 'in', xray_current.json.rows | default([]) | map(attribute='name') | list) | list }}"
loop_control:
label: "{{ item.name }}"
register: xray_added
changed_when: true
no_log: true
- name: Обновить изменённые подписки
ansible.builtin.uri:
url: "https://{{ opnsense_host }}/api/xray/instance/setItem/{{ item.0.uuid }}"
method: POST
url_username: "{{ opnsense_api_key }}"
url_password: "{{ opnsense_api_secret }}"
force_basic_auth: true
validate_certs: false
body_format: json
body:
instance: "{{ xray_payloads[item.0.name] }}"
status_code: [200]
- name: Синхронизировать подписки Xray на OPNsense
ansible.builtin.command: "python3 {{ role_path }}/files/sync_xray.py"
args:
stdin: "{{ xray_sync_cfg | to_json }}"
vars:
cur: "{{ item.1.json.instance }}"
want: "{{ xray_payloads[item.0.name] }}"
# loglevel — OptionField: getItem отдаёт не строку, а список опций
# с флагами selected. Вытаскиваем ключ выбранной опции.
cur_loglevel_sel: "{{ cur.loglevel | dict2items | default([]) | selectattr('value.selected', 'equalto', 1) | map(attribute='key') | list }}"
cur_loglevel: "{{ cur_loglevel_sel[0] if cur_loglevel_sel | length > 0 else '' }}"
drift: >-
{{ (cur.outbound_config | default('') | from_json) != (want.outbound_config | from_json)
or cur.name != want.name
or (cur.enabled | string) != want.enabled
or (cur.socks5_listen | default('')) != want.socks5_listen
or (cur.socks5_port | string) != want.socks5_port
or (cur.tun_interface | default('')) != want.tun_interface
or (cur.mtu | string) != want.mtu
or (cur.bypass_networks | default('')) != want.bypass_networks
or cur_loglevel != want.loglevel }}
loop: "{{ xray_current.json.rows | default([]) | selectattr('name', 'in', xray_desired | map(attribute='name') | list) | list | zip(xray_existing.results) | list }}"
loop_control:
label: "{{ item.0.name }}"
register: xray_updated
when: drift
changed_when: true
xray_sync_cfg:
opnsense_host: "{{ opnsense_host }}"
instances: "{{ xray_wanted.instances }}"
socks5_listen: "{{ xray_socks5_listen }}"
socks5_port: "{{ xray_socks5_port }}"
tun_interface: "{{ xray_tun_interface }}"
mtu: "{{ xray_mtu }}"
bypass_networks: "{{ xray_bypass_networks }}"
loglevel: "{{ xray_loglevel }}"
environment: "{{ xray_sync_env }}"
register: xray_sync_raw
changed_when: (xray_sync_raw.stdout | from_json).changed
no_log: true
- name: Записать флаг необходимости перезапуска
- name: Разобрать итог синхронизации подписок Xray
ansible.builtin.set_fact:
xray_restart_needed: "{{ xray_toggle_stale is changed or xray_added is changed or xray_updated is changed }}"
- name: Определить uuid активной подписки
ansible.builtin.set_fact:
xray_active_uuid: "{{ uuid }}"
vars:
# first на пустой последовательности — фатальная ошибка, поэтому list + индекс
active_name: "{{ xray_desired | selectattr('active') | map(attribute='name') | first }}"
all_uuids: "{{ (xray_added.results | default([]) | selectattr('item.name', 'equalto', active_name) | map(attribute='json.uuid') | list)
+ (xray_current.json.rows | default([]) | selectattr('name', 'equalto', active_name) | map(attribute='uuid') | list) }}"
uuid: "{{ all_uuids[0] if all_uuids | length > 0 else '' }}"
- name: Проверить, что активная подписка найдена в OPNsense
ansible.builtin.assert:
that:
- xray_active_uuid | length > 0
fail_msg: "Активная подписка не найдена в OPNsense после синхронизации инстансов."
- name: Провалидировать конфиг активной подписки
ansible.builtin.uri:
url: "https://{{ opnsense_host }}/api/xray/service/validate/{{ xray_active_uuid }}"
method: POST
url_username: "{{ opnsense_api_key }}"
url_password: "{{ opnsense_api_secret }}"
force_basic_auth: true
validate_certs: false
body_format: json
body: {}
status_code: [200]
register: xray_validate
when: xray_restart_needed
- name: Остановить при невалидном конфиге
ansible.builtin.assert:
that:
- xray_validate.json.result == 'ok'
fail_msg: "xray -test отклонил конфиг активной подписки: {{ xray_validate.json.message }}"
when: xray_restart_needed
- name: Переконфигурировать сервис Xray
ansible.builtin.uri:
url: "https://{{ opnsense_host }}/api/xray/service/reconfigure"
method: POST
url_username: "{{ opnsense_api_key }}"
url_password: "{{ opnsense_api_secret }}"
force_basic_auth: true
validate_certs: false
body_format: json
body: {}
status_code: [200]
register: xray_reconfigure
when: xray_restart_needed
changed_when: true
- name: Проверить соединение активной подписки
ansible.builtin.uri:
url: "https://{{ opnsense_host }}/api/xray/service/testconnect/{{ xray_active_uuid }}"
method: POST
url_username: "{{ opnsense_api_key }}"
url_password: "{{ opnsense_api_secret }}"
force_basic_auth: true
validate_certs: false
body_format: json
body: {}
status_code: [200]
register: xray_test
when: xray_restart_needed
- name: Откатить переключение при нерабочем соединении
ansible.builtin.uri:
url: "https://{{ opnsense_host }}/api/xray/instance/toggleItem/{{ item.uuid }}/1"
method: POST
url_username: "{{ opnsense_api_key }}"
url_password: "{{ opnsense_api_secret }}"
force_basic_auth: true
validate_certs: false
body_format: json
body: {}
status_code: [200]
loop: "{{ xray_current.json.rows | default([]) | selectattr('enabled', 'equalto', '1') | selectattr('name', 'in', xray_stale | map(attribute='name') | list) | list }}"
loop_control:
label: "{{ item.name }}"
when:
- xray_restart_needed
- xray_test.json.result | default('') != 'ok'
- xray_prev_active | length > 0
changed_when: true
- name: Снова включить прежнюю активную подписку (откат)
ansible.builtin.uri:
url: "https://{{ opnsense_host }}/api/xray/service/reconfigure"
method: POST
url_username: "{{ opnsense_api_key }}"
url_password: "{{ opnsense_api_secret }}"
force_basic_auth: true
validate_certs: false
body_format: json
body: {}
status_code: [200]
when:
- xray_restart_needed
- xray_test.json.result | default('') != 'ok'
- xray_prev_active | length > 0
changed_when: true
- name: Удалить лишние инстансы после успешного переключения
ansible.builtin.uri:
url: "https://{{ opnsense_host }}/api/xray/instance/delItem/{{ item.uuid }}"
method: POST
url_username: "{{ opnsense_api_key }}"
url_password: "{{ opnsense_api_secret }}"
force_basic_auth: true
validate_certs: false
body_format: json
body: {}
status_code: [200]
loop: "{{ xray_stale }}"
loop_control:
label: "{{ item.name }}"
when:
- not xray_restart_needed or (xray_test.json.result | default('ok')) == 'ok'
changed_when: true
- name: Проверить статус сервиса Xray
ansible.builtin.uri:
url: "https://{{ opnsense_host }}/api/xray/service/status/{{ xray_active_uuid }}"
method: GET
url_username: "{{ opnsense_api_key }}"
url_password: "{{ opnsense_api_secret }}"
force_basic_auth: true
validate_certs: false
status_code: [200]
register: xray_status
xray_sync: "{{ xray_sync_raw.stdout | from_json }}"
- name: Итог синхронизации подписок Xray
ansible.builtin.debug:
msg:
- "Подписки: {{ xray_desired | map(attribute='name') | join(', ') }}"
- "Активна: {{ xray_desired | selectattr('active') | map(attribute='name') | first }}"
- "Статус сервиса: {{ xray_status.json.status | default('?') }}"
- "Перезапуск выполнен: {{ xray_restart_needed }}"
- "Тест соединения: {{ xray_test.json.message if xray_restart_needed else 'не запускался (без изменений)' }}"
- "Подписки: {{ xray_sync.instances | join(', ') }}"
- "Активна: {{ xray_sync.active }}"
- "Статус сервиса: {{ xray_sync.service_status }}"
- "Изменения: {{ xray_sync.changes }}"
- "Перезапуск выполнен: {{ xray_sync.restart_needed }}"
- "Тест соединения: {{ xray_sync.test_message }}"