--- # Синхронизация подписок Xray на OPNsense с файлом instances.yml. # Управление через API плагина os-xray (/api/xray/...), как в роли opnsense/netbird. - name: Проверить обязательные секреты OPNsense ansible.builtin.assert: that: - opnsense_api_key is defined and opnsense_api_key | length > 0 - opnsense_api_secret is defined and opnsense_api_secret | length > 0 fail_msg: "Отсутствуют OPNSENSE_API_KEY / OPNSENSE_API_SECRET (Infisical /services/opnsense)." - name: Прочитать список подписок 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: Сконвертировать ссылки в outbound_config ansible.builtin.command: python3 {{ role_path }}/files/vless_to_outbound.py args: stdin: "{{ lookup('env', item.secret, default='') }}" register: xray_conv 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] 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 no_log: true - name: Записать флаг необходимости перезапуска 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 }}" - 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 - 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 | default('не запускался (без изменений)') }}"