Files
homelab-infra/ansible/roles/opnsense/xray/tasks/main.yml
T

298 lines
12 KiB
YAML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
# Синхронизация подписок 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] }}"
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 | default('')) != 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:
uuid: "{{ (xray_added.results | default([]) | selectattr('item.name', 'equalto', active_name) | map(attribute='json.uuid') | first)
or (xray_current.json.rows | default([]) | selectattr('name', 'equalto', active_name) | map(attribute='uuid') | first) }}"
active_name: "{{ xray_desired | selectattr('active') | map(attribute='name') | first }}"
- 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"
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('не запускался (без изменений)') }}"