outline-vpn-basic

name	outline-vpn-basic
description	KISS operations skill for Outline VPN on VPS (install, key lifecycle, status, limits).
enabled	true

outline-vpn-basic

Назначение:

• управлять Outline VPN на VPS простыми командами;
• покрыть полный цикл ключей: создать, доздать, удалить, лимит/безлимит;
• хранить чувствительные данные только вне репозитория.

Что включает:

1. Установка Outline на VPS.
2. Синхронизация manager-конфига (apiUrl, certSha256) в локальный приватный каталог.
3. Просмотр статуса сервера и списка ключей.
4. Создание ключей (по умолчанию без лимита).
5. Удаление ключей (точечно и batch).
6. Включение/снятие лимитов трафика.

Основной инструмент:

• scripts/outlinectl.sh

Быстрый старт:

# 1) установка и первичная конфигурация
bash scripts/outlinectl.sh install \
  --host-id agents-prod-01 \
  --ssh-host root@<your-vps-ip>

# 2) создать 8 безлимитных ключей
bash scripts/outlinectl.sh keys-create \
  --host-id agents-prod-01 \
  --count 8 \
  --name-prefix p11-unlimited

# 3) показать ключи (без вывода access_url в stdout)
bash scripts/outlinectl.sh keys-list --host-id agents-prod-01

Где хранятся приватные данные:

• manager config: ${XDG_CONFIG_HOME:-$HOME/.config}/codex/outline/<host-id>.manager.env
• экспорт ключей: ${XDG_CONFIG_HOME:-$HOME/.config}/codex/outline/<host-id>-keys-<timestamp>.txt

KISS-правила:

1. Один script (outlinectl.sh) и явные подкоманды.
2. Без хранения ключей/API URL в репозитории.
3. Опасные операции (keys-delete-all) требуют --yes.

Reference:

• references/OUTLINE_VPN_GUIDELINES.md

Ограничения:

• для VPS операций нужен обычный ssh-доступ к серверу;
• команды key-management требуют валидный manager config;
• любые массовые удаления делать только после keys-list и backup/export.