Сайты и приложения
Как выложить Go-приложение в интернет
Коротко
Чтобы выложить Go-приложение в интернет, загрузите исходный код с файлом go.mod и слушайте порт из переменной окружения PORT — бинарь собирать самому не нужно. Netrun определяет Go по go.mod, сам скачивает зависимости, собирает проект и выдает ссылку с HTTPS. Ключи и строку подключения к базе приложение читает через os.Getenv из секретов, которые задаются в кабинете.
- Файл go.mod в корне проекта сообщает Netrun, что это Go-приложение, и перечисляет зависимости для сборки.
- Go-сервис должен слушать порт из переменной окружения PORT, который читается через os.Getenv("PORT").
- Адрес вида ":"+port в Go означает «слушать на всех адресах», а сервер на "127.0.0.1" снаружи недоступен.
- Собирать бинарь локально и ставить Go на сервер не нужно: Netrun собирает проект из исходников сам.
- Секреты Netrun хранит зашифрованными и передает приложению как переменные окружения.
Обычно, чтобы показать миру Go-приложение, нужно арендовать сервер, собрать на нем бинарь, поставить рядом nginx как прокси, получить SSL-сертификат и следить, чтобы процесс не падал. Go удобен тем, что весь проект компилируется в один исполняемый файл, но работа вокруг сервера от этого никуда не девается.
Netrun убирает эту часть: вы загружаете исходный код, мы сами видим, что это Go, собираем проект и выдаем публичную ссылку с HTTPS (защищенное соединение, замочек в браузере). Ни сервера, ни nginx, ни ручного сертификата — ниже о том, как пройти путь от папки с кодом до рабочей ссылки.
Проверьте, что в корне есть go.mod#
Файл go.mod в корне проекта перечисляет зависимости и говорит Netrun, что перед ним Go-приложение. Папку с зависимостями (например, vendor) класть не нужно — библиотеки мы подтянем сами по go.mod при сборке.
Читайте порт из переменной окружения#
Если у вас веб-сервис, он должен слушать тот порт, который задает Netrun через переменную окружения PORT, а не прописанный в коде намертво. На практике это значит взять порт через os.Getenv("PORT") и слушать именно его — тогда мы автоматически пробросим наружу нужный адрес. Захардкоженный порт сломал бы публикацию.
Загрузите код#
Откройте Netrun и принесите проект одним из двух способов: ZIP-архивом с исходниками или импортом из GitHub-репозитория, в том числе приватного. Достаточно самого кода с go.mod — собирать бинарь у себя и ставить Go где-либо не нужно, все происходит у нас.
Укажите секреты, если они есть#
Если приложение ходит во внешний сервис или базу данных, ключи API, токены и строку подключения мы спросим при настройке. Они подставятся в переменные окружения и не будут лежать в коде — читайте их из окружения через os.Getenv так же, как порт.
Дождитесь сборки и заберите ссылку#
Netrun сам соберет проект и поднимет его. Логи и статус публикации видны в кабинете в реальном времени, так что вы сразу заметите, если что-то пошло не так. Когда все готово, вы получите публичную ссылку с HTTPS — ее можно открывать и отправлять кому угодно.
Готово: ваше Go-приложение доступно в интернете без аренды сервера и настройки SSL. На бесплатном тарифе доступен один проект, и веб-сервис на нем засыпает при простое и просыпается по запросу — первый ответ после паузы будет чуть медленнее. Если приложение должно отвечать без задержек постоянно, подойдет платный тариф с работой без простоев, а если проектов нужно больше — можно оплатить места под них. Попробовать Netrun.
Частые вопросы
Как правильно прочитать порт в Go?
Возьмите его из окружения: port := os.Getenv("PORT"), и запустите сервер через http.ListenAndServe(":"+port, handler). Запись с двоеточием без адреса означает «слушать на всех адресах» — это и нужно. Для локального запуска подставьте значение по умолчанию, если переменная пустая.
Нужно ли класть в архив папку vendor?
Нет. Зависимости подтягиваются при сборке по go.mod и go.sum, поэтому достаточно исходного кода. Следите, чтобы go.sum был актуальным: без нужных записей в нем сборка может остановиться на проверке зависимостей.
Можно ли выложить Go-программу без веб-сервера, например бота?
Да. Если программа не слушает порт, Netrun запустит ее как фоновый процесс без публичной ссылки — так работают боты и скрипты. На бесплатном тарифе такой проект работает ограниченное время, а круглосуточно — на тарифе Pro.
Почему Go-сайт иногда открывается не сразу?
На бесплатном тарифе веб-сервис засыпает без посетителей и просыпается при первом запросе, поэтому первое открытие после паузы занимает несколько секунд. На тарифе Pro проект не засыпает и отвечает сразу.
Где Go-приложению хранить файлы и базу SQLite?
В постоянной папке /data: все, что приложение туда пишет, переживает обновление кода и перезапуск. Файлы вне /data при следующей публикации пропадают.