Хостинг сервера в Google Colab без ngrok и cloudflared

Зачем это нужно

Когда нужно получить доступ к серверу, запущенному в Colab, стандартное решение — внешние туннели. Но у популярных инструментов есть проблемы:

ngrok — TCP-эндпоинты теперь требуют привязки банковской карты. Формально бесплатно, но карту давай.

cloudflared — периодические таймауты при работе с Colab, плюс каждый перезапуск ноутбука генерирует новый случайный субдомен.

При этом в Colab есть встроенный механизм для проксирования портов, который большинство игнорирует.

Как работает proxyPort

Colab предоставляет функцию google.colab.output.eval_js, которая позволяет получить публичный URL для любого локального порта:

from google.colab.output import eval_jsurl = eval_js("google.colab.kernel.proxyPort(8000)")print(url)

На выходе — URL вида https://{port}-{instance-id}.{region}.prod.colab.dev. Это не туннель, а встроенный прокси самого Colab.

Проблема: просто так не достучаться

Если попробовать сделать запрос по этому URL через requests — ничего не выйдет. Colab защищает доступ к порту через аутентификацию на основе куки.

Нужный куки называется colab-runtime-proxy-token . Получить его можно только из браузерной сессии с активным Colab:

1. Открыть URL в браузере

2. Открыть DevTools → Application → Cookies

3. Найти colab-runtime-proxy-token

Решение: передаём токен в запросах

Имея токен, можно обращаться к серверу программно из любого места:

import requestsurl = "https://{port}-{instance-id}.{region}.prod.colab.dev/endpoint"cookies = {"colab-runtime-proxy-token": "ВАШ_ТОКЕН"}response = requests.get(url, cookies=cookies)

Полный пример

В Colab — запускаем сервер:

from fastapi import FastAPIimport uvicornfrom google.colab.output import eval_jsimport threadingapp = FastAPI()@app.get("/ping")def ping():    return {"status": "ok"}url = eval_js("google.colab.kernel.proxyPort(8000)")print(f"URL: {url}")threading.Thread(target=lambda: uvicorn.run(app, host="0.0.0.0", port=8000)).start()

Или

url = eval_js("google.colab.kernel.proxyPort(8000)")print(f"URL: {url}")from fastapi import FastAPIimport uvicornfrom google.colab.output import eval_jsimport threadingapp = FastAPI()@app.get("/ping")def ping():    return {"status": "ok"}uvicorn.run(app, host="0.0.0.0", port=8000)

Снаружи — делаем запрос:

import requestsurl = "https://{port}-{instance-id}.{region}.prod.colab.dev/ping"cookies = {"colab-runtime-proxy-token": "ВАШ_ТОКЕН"}print(requests.get(url, cookies=cookies).json())# {'status': 'ok'}

Ограничения

• Сервер живёт пока Colab не отключит runtime (до 12 часов на бесплатном плане)

• URL меняется при каждом перезапуске ноутбука