Как подключить свой сервер у другого хостинга

Если у вас уже есть сервер у любого хостинга, appagent может работать и на нём. Подключение выполняется одной командой по SSH. Этот вариант для опытных пользователей: если вы не уверены, выберите свой компьютер или Timeweb.

SSH (от английского Secure Shell) — защищённый способ удалённо войти на сервер и выполнять на нём команды. Вход происходит не по паролю, а по ключу: это пара файлов, один у вас на компьютере, второй на сервере. Это единственная страница справки, где нужно знать это слово.

Для кого

Для тех, у кого уже есть сервер и кто умеет входить на него из терминала.

Что понадобится

  • Сервер с Ubuntu (проверена версия 24.04 LTS). Другая версия Ubuntu даёт предупреждение, другая система не подойдёт.
  • Адрес сервера (IP или имя) и пользователь с правом sudo без пароля (sudo — выполнение команд с правами администратора) либо root.
  • SSH-ключ, добавленный на сервер. Если ключа нет, создайте его: ssh-keygen -t ed25519.
  • Страна сервера из списка поддерживаемых Anthropic. Россия и Беларусь не подходят: оттуда не работает Claude. Страну выбираете вы при заказе.

Шаги

  1. Убедитесь, что вход по ключу работает: ssh пользователь@адрес.
  2. Выполните на вашем компьютере:
   orch server setup --provider ssh --host 203.0.113.10 --user root --key ~/.ssh/id_ed25519

Подставьте свой адрес вместо 203.0.113.10. На свежем сервере пользователя orch ещё нет: он создаётся на шаге подготовки (шаг 5), поэтому первый запуск делайте от root или от пользователя с sudo. Необязательные флаги: --port (по умолчанию 22), --name (имя сервера), --no-verify (не проверять вход).

  1. Команда проверит вход по ключу, систему, sudo, Node.js и Claude Code. Если Node.js или Claude Code нет, это предупреждение: их ставит следующий шаг.
  2. Подготовьте сервер. Сначала посмотрите план:
   orch server bootstrap --dry-run
  1. Затем выполните подготовку (нужен терминал; первый запуск — от root или пользователя с sudo):
   orch server bootstrap
  1. Проверьте результат: orch server status.

Что вы увидите

orch server status показывает, что сервер отвечает, и сведения о нём: система, Node.js, Claude Code, sudo. Ключи и токены appagent не хранит: в настройках остаются адрес, пользователь, порт и путь к ключу.

Автовыключения нет

Для такого сервера appagent не умеет включать и выключать машину. orch server up только проверяет, отвечает ли сервер, а orch server down всегда отказывает и подсказывает команду ssh пользователь@адрес sudo poweroff. Включать и выключать сервер нужно у хостинга.

Если не получилось

  • Сервер не принял ключ. Проверьте --user и --key, публичный ключ должен лежать в ~/.ssh/authorized_keys на сервере.
  • Файл ключа не найден. Создайте ключ ssh-keygen -t ed25519 и поправьте путь в --key.
  • Ключ хоста не совпал с known_hosts. Так бывает после переустановки сервера: выполните ssh-keygen -R адрес и повторите.
  • Адрес не найден или сервер недоступен. Проверьте --host и --port, что сервер включён у хостинга и что брандмауэр пропускает SSH.
  • Нужна Ubuntu. Переустановите сервер с Ubuntu 24.04 в панели хостинга.
  • Нет sudo без пароля. Дайте пользователю sudo без пароля или используйте --user root для первой подготовки.

Другие случаи: «Если что-то не работает».

Частые вопросы

Зачем нужен SSH?

Через него appagent входит на ваш сервер, проверяет его и устанавливает нужное. Для остальных вариантов (свой компьютер, Timeweb) это не требуется.

Можно ли использовать не Ubuntu?

Нет, нужна Ubuntu. Проверена версия 24.04 LTS.

Хранит ли appagent мой SSH-ключ?

Нет. В настройках записан только путь к файлу ключа, сам ключ appagent не читает и не сохраняет.

Как потом работать с сервера с телефона или ноутбука?

Через пульт my.appagent.ru: о пульте и другие устройства.

Все разделы справки