Cannot use fxtunnel on headless Armbian without Secret Service

[umniystakan]

fxTunnel version

v3.10.0

Component

CLI Client

Operating System

Linux

Description

On headless Linux systems, the CLI requires a Secret Service implementation (org.freedesktop.secrets) to store the authentication token. Since headless servers typically do not provide this service, authentication is impossible.

Additionally, the global --token flag does not allow using the CLI without a successful login, making the client unusable on headless environments such as Debian Server or Armbian.

The CLI should either support authentication without Secret Service or allow the --token flag to bypass the login requirement.

Steps to reproduce

1. Install fxtunnel on a headless Linux system (e.g. Armbian or Debian Server).
2. Run fxtunnel login -t <API_TOKEN>.
3. Observe that authentication fails because org.freedesktop.secrets is unavailable.
4. Try using the CLI with fxtunnel -t <API_TOKEN> domains list.
5. Observe that the client still requires a successful login and ignores the provided token.

Logs

Configuration

[umniystakan]

ответь на иссуе пожалуйста

[umniystakan]

ответь пожалуйста

[mephistofox]

Исправлено, войдёт в ближайший релиз. Спасибо за подробный репорт - вы были правы по обоим пунктам.

Что изменилось в CLI-клиенте:

1. login больше не требует Secret Service. Когда системный keyring недоступен (headless Linux без org.freedesktop.secrets), fxtunnel login -t <token> теперь сохраняет токен в ~/.fxtunnel/client.yaml (права 0600). В выводе будет: System keyring unavailable - token saved to ... instead.

2. Флаг --token и новая env-переменная теперь работают вообще без логина. Все команды резолвят токен по порядку: --token/-t → FXTUNNEL_TOKEN (и FXTUNNEL_SERVER_ADDRESS) → keyring → ~/.fxtunnel/client.yaml. Так что на headless-машине без keyring теперь работает и то, и другое:

# по токену на каждую команду, без логина
fxtunnel -t <API_TOKEN> domains list

# или через переменную окружения
export FXTUNNEL_TOKEN=<API_TOKEN>
fxtunnel http 8080

logout теперь тоже удаляет токен из файла.

Отпишусь здесь, когда выйдет релиз с фиксом. Если можете собрать из исходников - изменения уже в основной ветке.

[mephistofox]

Фикс вышел в релизе v3.11.1 - бинарники уже доступны, включая ARM64 для Armbian.

Что можно сделать на вашей headless-машине (любой из вариантов):

# скачать клиент под Armbian (ARM64)
curl -L -o fxtunnel https://github.com/mephistofox/fxtun.dev/releases/download/v3.11.1/fxtunnel-linux-arm64
chmod +x fxtunnel

# вариант 1: login теперь работает без keyring - токен уйдёт в ~/.fxtunnel/client.yaml (0600)
./fxtunnel login -t <API_TOKEN>

# вариант 2: вообще без логина - флаг на каждую команду
./fxtunnel -t <API_TOKEN> domains list

# вариант 3: через переменную окружения
export FXTUNNEL_TOKEN=<API_TOKEN>
./fxtunnel http 8080

Порядок резолва токена во всех командах: --token/-t → FXTUNNEL_TOKEN → системный keyring → ~/.fxtunnel/client.yaml. logout теперь тоже чистит токен из файла.

Спасибо ещё раз за репорт. Если на Armbian что-то ещё не так - пишите, переоткроем.