Поделиться каналом · Руководство по настройке

Держите ПК или NAS онлайн, чтобы обеспечить выход в материковую сеть. Выполните шаги ①–③ для загрузки, затем пройдите пошаговое руководство для новичков ниже.

① Войдите в Univista

Используйте зарегистрированный email. Если у вас ещё нет аккаунта, зарегистрируйтесь и купите тариф.

Войти Регистрация Кабинет Домашний узел · Мастер настройки
② Скопируйте подписку (опционально — ссылка Shadowrocket)

Откройте «Панель управления» и скопируйте ссылку «Shadowrocket / универсальная». Зарубежные пользователи используют её как обычно; участникам важен следующий шаг — туннель.

③ Установите клиент frp и подключитесь к Сингапуру

На постоянно работающей машине скачайте и запустите только frpc (клиент — той же версии, что в таблице ниже). После регистрации через «Заработок → Поделиться каналом» или API укажите serverAddr, token и remotePort в frpc.toml. См. ops doc 56. «Нет активных узлов» — это нормально, пока туннель не поднят.

Общие инструкции по установке (распаковка, frpc и frps) есть на сайте документации проекта: Открыть официальную документацию — установка

Выберите архив для вашей системы (v0.61.0)

«Прямая загрузка» сразу скачивает файл (без страницы релизов GitHub). Если загрузка медленная, повторите или используйте свой обычный сетевой путь.

Устройство / сценарий	Имя файла архива	Действие
Windows 10/11 64-бит (большинство ПК)	frp_0.61.0_windows_amd64.zip	Прямая загрузка
Windows ARM64 (например, некоторые Surface)	frp_0.61.0_windows_arm64.zip	Прямая загрузка
macOS на Apple Silicon (M1 / M2 / M3 / M4)	frp_0.61.0_darwin_arm64.tar.gz	Прямая загрузка
macOS Intel (старые Mac)	frp_0.61.0_darwin_amd64.tar.gz	Прямая загрузка
Linux десктоп / x86 сервер / многие NAS (amd64)	frp_0.61.0_linux_amd64.tar.gz	Прямая загрузка
Linux ARM64 (например, 64-битный Raspberry Pi, некоторые ARM NAS)	frp_0.61.0_linux_arm64.tar.gz	Прямая загрузка
Linux ARM 32-бит (старые 32-битные образы Pi и т. п.)	frp_0.61.0_linux_arm.tar.gz	Прямая загрузка

Используйте frpc из архива; frps дома запускать не нужно. Эта таблица соответствует серверному релизу Univista: v0.61.0

Руководство для новичков: регистрация, конфиг, запуск

Предполагается, что вы умеете открывать Терминал на macOS. При необходимости попросите кого-нибудь выполнить команды за вас. Замените YOUR_EMAIL / YOUR_PASSWORD на свои учётные данные Univista.

Распакуйте архив и найдите файл frpc. Не запускайте frps дома — это серверный файл.
Если macOS сообщает, что разработчик не может быть проверен: выполните один раз: xattr -cr /path/to/the/extracted/folder (папка должна содержать frpc), например xattr -cr ~/Downloads/frp_0.61.0_darwin_arm64. Или в Finder: правый клик по frpc → «Открыть» → ещё раз «Открыть».
При необходимости выполните chmod +x frpc, чтобы ./frpc работал в Терминале.
Используйте команды ниже. Если вы уже зарегистрированы, POST /register вернёт ошибку — вместо этого используйте GET /api/agent/config с тем же токеном Bearer. Сохраните frps_host, frps_port, virtual_port, frps_token для auth.token; remotePort должен равняться virtual_port.
Создайте текстовый файл с именем frpc.toml рядом с frpc (переименуйте, если редактор добавил .txt).
Отредактируйте образец: задайте auth.token равным frps_token, а remotePort — virtual_port (должен быть в диапазоне 18000–19999).
В одном терминале запустите python3 -m http.server 8765; в другом — ./frpc -c frpc.toml и ищите login success / start proxy success.

Выполните в Терминале (вход, затем регистрация)

Требуется Python 3. Если получаете 404, возможно, CN_AGENT_ENABLED отключён на сервере.

curl -sS -X POST "https://univista.me/api/auth/login" \
  -H "Content-Type: application/json" \
  -d '{"email":"YOUR_EMAIL","password":"YOUR_PASSWORD"}'

TOKEN=$(curl -sS -X POST "https://univista.me/api/auth/login" \
  -H "Content-Type: application/json" \
  -d '{"email":"YOUR_EMAIL","password":"YOUR_PASSWORD"}' \
  | python3 -c "import sys,json; print(json.load(sys.stdin)['access_token'])")

curl -sS -X POST "https://univista.me/api/agent/register" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"device_name":"home","region":""}'

Уже зарегистрированы? Получите настройки туннеля (без повторной регистрации)

Используйте тот же $TOKEN из входа. JSON содержит frps_token и virtual_port для frpc.toml.

curl -sS "https://univista.me/api/agent/config" \
  -H "Authorization: Bearer $TOKEN"

Пример frpc.toml (используйте значения из ответа регистрации)

Если frps_host в JSON отличается от образца, используйте значение из JSON для serverAddr.

serverAddr = "139.180.184.227"
serverPort = 17980

auth.method = "token"
auth.token = "PASTE_frps_token_FROM_REGISTER_RESPONSE"

[[proxies]]
name = "test-tcp"
type = "tcp"
localIP = "127.0.0.1"
localPort = 8765
remotePort = 18000

Замените 18000 на ваш virtual_port. auth.token должен точно совпадать с frps_token (не с токеном heartbeat агента). Ошибка «token in login doesn't match» означает, что auth.token ≠ серверному токену.

Запуск (два окна терминала)

cd /path/to/extracted/folder
python3 -m http.server 8765
# Second terminal:
./frpc -c frpc.toml

Устранение неполадок

macOS сообщает, что frpc нельзя проверить

Лучше всего: выполните xattr -cr один раз для папки с frpc. Или Finder → правый клик по frpc → «Открыть». См. шаги для новичков выше.
Ошибка: token in login doesn't match token from configuration

auth.token должен точно совпадать с frps_token из API регистрации (как на сервере frps). Не используйте JWT или секрет heartbeat агента. Следите за лишними пробелами.
Можно ли использовать remotePort 6000?

Нет. Только 18000–19999, и значение должно равняться назначенному вам virtual_port.
Где находятся логи?

По умолчанию — в том же терминале, где запущен frpc. Или: ./frpc -c frpc.toml 2>&1 | tee frpc.log

Должен ли ПК оставаться включённым?

Да. То, на чём работают frpc и локальный прокси, должно оставаться онлайн (ПК, NAS или роутер). Когда устройство спит или выключено, другие не могут использовать ваш канал.

Партнёрка