Ваш інстанс Cloud SQL не має публічної IP-адреси.
Дістаньтеся його за назвою, без бастіон-ВМ.
AgentsRoom запускає Cloud SQL Auth Proxy, коли ви відкриваєте з'єднання, і спрямовує на нього свій клієнт баз даних. Ви вказуєте назву з'єднання з інстансом, project:region:instance, або вибираєте його зі списку, який бачить ваш власний вхід у gcloud.
Проксі авторизується вашими Application Default Credentials, тож AgentsRoom не зберігає ключ службового облікового запису. З автентифікацією в базі даних через IAM немає й пароля до бази. А AI-агент для кодування може надсилати запити до того самого інстанса, лише для читання.
Як AgentsRoom дістається інстанса Cloud SQL за приватною IP-адресою через Cloud SQL Auth Proxy, нічого не зберігаючи на боці застосунку.
Інстанс Cloud SQL лише з приватною IP-адресою: конфігурація правильна, але незручна. База живе у вашому VPC, її публічна IP-адреса вимкнена, і дістатися до неї можуть лише машини всередині цієї мережі. А потім треба глянути на три рядки, щоб розібратися з багом, причому з ноутбука.
Google уже має відповідь: Cloud SQL Auth Proxy. Він відкриває зашифроване з'єднання з інстансом, авторизоване вашим обліковим записом Google, а не списком дозволених IP-адрес, і віддає його як локальний порт. Незручне все навколо: встановити його, пам'ятати назву з'єднання з інстансом, запускати в терміналі перед відкриттям клієнта і потім забувати, що він досі працює.
AgentsRoom бере це на себе. У полі «Підключатися через» з'єднання з базою ви вибираєте Google Cloud SQL, вказуєте інстанс, за потреби позначаєте «Приватна IP-адреса» або «Автентифікація в базі даних через IAM», і далі відкрити цю базу можна одним кліком. Проксі стартує разом із з'єднанням і зупиняється разом із ним.
Звичайні обхідні шляхи завжди чогось коштують
Три відповіді на одну й ту саму проблему і ціна, яку доводиться платити за кожну.
Бастіон-ВМ лише заради цього
ВМ Compute Engine з портом SSH, яку тримають у VPC лише для того, щоб час від часу прокинути тунель до бази. Її треба оновлювати, вона коштує грошей щогодини, а її SSH-ключі та правила брандмауера розходяться з реальністю зі зміною складу команди.
Публічна IP-адреса і список дозволених
Увімкнути публічну IP-адресу й додати домашню адресу до авторизованих мереж можна, і це працює, доки адреса не зміниться, а весь цей час база слухає інтернет. Це виняток, який ніхто ніколи не прибирає.
Ключ службового облікового запису на ноутбуці
Завантажити JSON-ключ, щоб запустити проксі, це шлях навпростець, про який шкодують усі: довгоживучі облікові дані в теці «Завантаження», скопійовані в скрипти та промпти, які ніхто не ротує і не може відстежити.
Від приватного інстанса Cloud SQL до набору результатів
Чотири кроки, зроблені один раз, а далі все одним кліком.
Увійдіть через gcloud, один раз
Виконайте на своїй машині gcloud auth application-default login. Створені так Application Default Credentials проксі використовує, щоб дістатися інстанса. AgentsRoom нічого з цього не читає і не зберігає.
Виберіть інстанс у полі «Підключатися через»
Створіть з'єднання MySQL або PostgreSQL і виберіть Google Cloud SQL у полі «Підключатися через». Введіть назву з'єднання з інстансом, project:region:instance, або натисніть «Показати мої інстанси», щоб вибрати його з тих, що бачить ваш вхід у gcloud. Хост і порт зникають: адресою стає сам інстанс.
Виберіть приватну IP-адресу й автентифікацію IAM
Позначте «Приватна IP-адреса», коли інстанс не має публічної адреси, а ваша машина потрапляє до його VPC через VPN або Interconnect. Позначте «Автентифікація в базі даних через IAM», щоб входити своїм обліковим записом Google: поле пароля зникає, а користувачем стає ваш користувач бази IAM.
Надсилайте запити самі або доручіть це агентові
Відкриття з'єднання резервує вільний loopback-порт, запускає на ньому cloud-sql-proxy і чекає, доки той почне приймати TCP-з'єднання. Консоль підключається до 127.0.0.1 як до будь-якого іншого з'єднання, а AI-агент може надсилати запити через MCP, лише для читання. Закриття з'єднання зупиняє проксі.
Команда, яку запускає AgentsRoom
Нічого не переписано наново. AgentsRoom запускає як дочірній процес власний бінарний файл cloud-sql-proxy від Google (версія 2), передаючи аргументи напряму, а не через оболонку. Якщо ви колись запускали проксі вручну, це той самий рядок, який ви вже знаєте.
cloud-sql-proxy acme-prod:europe-west1:orders \
--address 127.0.0.1 --port 54321 \
--private-ip \
--auto-iam-authnІнстанс і дві опції беруться зі збереженого вами з'єднання. Локальний порт операційна система вибирає в момент відкриття.
Проксі приймає локальне з'єднання до будь-яких перевірок, а потім розриває його і пише в лог, що не так. AgentsRoom читає цей лог і називає справжню причину: проксі не встановлено, ваш вхід у gcloud сплив (з командою, яку треба виконати), у вашого облікового запису немає ролі Cloud SQL Client, інстанс не має приватної IP-адреси або назву інстанса вказано неправильно.
Що має бути виконано, щоб усе запрацювало
AgentsRoom працює з вашою конфігурацією Google Cloud і не замінює її. Це ті самі умови, яких вимагає сам проксі.
cloud-sql-proxy на вашій машині
Версія 2 Cloud SQL Auth Proxy, доступна в PATH. Найшвидше встановити її командою gcloud components install cloud-sql-proxy; Google також випускає її як окреме завантаження. Якщо проксі немає, AgentsRoom так і каже та називає команду.
Application Default Credentials
gcloud auth application-default login, виконаний один раз. Коли цей вхід спливе, помилка підкаже виконати його знову, а не покаже закритий сокет.
Роль Cloud SQL Client
Вашому акаунту Google потрібна роль Cloud SQL Client у проєкті інстанса, і там має бути ввімкнено Cloud SQL Admin API. Для автентифікації в базі даних через IAM додатково потрібні роль Cloud SQL Instance User і користувач IAM на інстансі.
gcloud для списку вибору
«Показати мої інстанси» виконує gcloud sql instances list у вашому активному проєкті або в проєкті, який ви почали вводити. Без gcloud назву з'єднання все одно можна ввести вручну.
Маршрут до VPC для приватної IP-адреси
Приватна IP-адреса означає, що сама ваша машина має дістатися до VPC інстанса через VPN, Interconnect або машину всередині мережі. Без такого маршруту залиште «Приватна IP-адреса» вимкненою і використовуйте публічну адресу із шифруванням проксі.
Що проксі робить і від чого відмовляється
Властивості, від яких залежить, чи безпечно лишати його налаштованим на ноутбуці.
Лише loopback
Проксі слухає 127.0.0.1 і більше нічого. База ніколи не публікується повторно в локальній мережі, тож Wi-Fi в кав'ярні не стає дорогою до продакшену.
Порт вибирає ОС
AgentsRoom просить в операційної системи вільний порт і передає його проксі. Ніякого фіксованого порту, який треба пам'ятати, і жодних конфліктів з іншим проксі, запущеним вручну.
Готово означає готово
З'єднання відкривається, лише коли локальний порт приймає TCP, а проксі, що одразу завершився, повідомляє причину, яку сам вивів. Жодних довільних пауз, жодного клієнта, що підключився надто рано.
Ключ не зберігається
Проксі авторизується вашими Application Default Credentials. AgentsRoom зберігає назву з'єднання з інстансом і дві опції, жодна з яких не є обліковими даними, а ключ службового облікового запису в застосунок не потрапляє ніколи.
База лишається лише для читання
З'єднання з базою створюється лише для читання. Для запису треба зробити з'єднання придатним для запису й явно підтвердити дію, суворіше для з'єднання, позначеного як продакшен.
Одна команда на виклик
Кожен виклик несе рівно одну команду, тож за крапкою з комою нічого не сховається, а набори результатів обмежені, щоб широкий запит не засипав вікно чи контекст агента.
Чому це менше доступу, а не більше
З боку інстанса нічого не відкривається. Публічна IP-адреса може лишатися вимкненою, жодна мережа не додається до списку авторизованих, і не треба тримати ВМ з портом SSH заради нечастого запиту. Проксі шифрує з'єднання з інстансом наскрізно.
Авторизація лишається там, де нею керує ваша організація: у вашому обліковому записі Google та його ролях IAM. Доступ, наданий цьому обліковому запису, фіксується в логах як будь-яке інше підключення до Cloud SQL і закінчується в день, коли роль відкликано. AgentsRoom зберігає назву інстанса, вибір «Приватна IP-адреса» та вибір IAM, і нічого, що міг би відтворити той, хто це прочитав.
З боку бази діють ті самі обмеження, що й у кожного з'єднання AgentsRoom: типово лише читання, одна команда на виклик, обмежені набори результатів і прапорець продакшену, що посилює підтвердження запису. AI-агент, який надсилає запити через MCP, отримує набір результатів, але не облікові дані, і не може писати, доки ви не зробили з'єднання придатним для запису й не ввімкнули для нього «Дозволити агентам запис».
MySQL і PostgreSQL, SQL Server поки що ні
У Cloud SQL працюють MySQL, PostgreSQL і SQL Server. AgentsRoom дістається через проксі перших двох, а клієнта SQL Server сьогодні не має. AlloyDB, який має власний проксі, теж не підтримується.
Який рушій чи сервіс з'явиться наступним, вирішують запити користувачів. Якщо вашого бракує, напишіть, якого саме, у публічному беклозі, і його порахують.
Попросіть підтримку свого рушія бази данихАгент теж може надсилати запити, лише для читання
Коли з'єднання створено, AI-агент для кодування користується ним через AgentsRoom MCP, називаючи його за іменем: db_list, db_schema, щоб пройтися таблицями й стовпцями, db_query для однієї команди з обмеженою кількістю рядків. Агент також може сам зареєструвати з'єднання з Cloud SQL через db_connection_new або db_connection_save, вказавши назву з'єднання з інстансом.
AgentsRoom сам запускає проксі, коли його просить агент, тож агент ніколи не має справи з обліковими даними Google, паролем бази чи номером порту. Назад повертається лише набір результатів. Для запису потрібні з'єднання, придатне для запису, і налаштування «Дозволити агентам запис», типово вимкнене.
Агент, що налагоджує проблему на продакшен-репліці, читає рядки, які пояснюють баг, без облікових даних, що могли б витекти до його контексту, і без шляху до бази після закриття застосунку.
FAQ
Як підключитися до інстанса Cloud SQL, який має лише приватну IP-адресу?
Створіть з'єднання MySQL або PostgreSQL, виберіть Google Cloud SQL у полі «Підключатися через», вкажіть назву з'єднання з інстансом і позначте «Приватна IP-адреса». AgentsRoom запускає Cloud SQL Auth Proxy з --private-ip на loopback-порту і підключає до нього свій клієнт. Ваша машина має діставати до VPC інстанса, наприклад через VPN або Interconnect.
Чи зберігає AgentsRoom ключ службового облікового запису?
Ні. Проксі авторизується тими Application Default Credentials, які створив на вашій машині gcloud auth application-default login. AgentsRoom зберігає назву з'єднання з інстансом і дві опції, жодна з яких не є обліковими даними.
Чи можна підключитися без пароля до бази?
Так, з автентифікацією в базі даних через IAM. Позначте її в з'єднанні, і проксі запуститься з --auto-iam-authn: він увійде вашим обліковим записом Google, поле пароля зникне, а користувачем стане ваш користувач бази IAM. На інстансі має бути ввімкнено автентифікацію IAM, а цього користувача створено.
Що потрібно встановити?
Cloud SQL Auth Proxy версії 2 (gcloud components install cloud-sql-proxy або окреме завантаження від Google) і вхід у gcloud для Application Default Credentials. Сам gcloud потрібен лише для кнопки «Показати мої інстанси».
Що буде, коли мій вхід у gcloud спливе?
Проксі відхиляє з'єднання і пише причину в лог. AgentsRoom читає цей лог і показує зрозуміле повідомлення з проханням виконати gcloud auth application-default login замість голої помилки з'єднання. Після цього ви повторюєте спробу.
Який локальний порт використовується і хто може до нього дістатися?
Вільний порт вибирає операційна система під час відкриття з'єднання, а проксі слухає лише 127.0.0.1. Ніщо в локальній мережі до нього не дістанеться, і проксі зупиняється, коли з'єднання закривається або застосунок завершує роботу.
Які рушії Cloud SQL підтримуються?
Cloud SQL for MySQL і Cloud SQL for PostgreSQL. Cloud SQL for SQL Server не підтримується, бо AgentsRoom поки не має клієнта SQL Server; попросіть про нього в публічному беклозі, і його порахують.
Чи працює це на Windows і Linux?
Так. cloud-sql-proxy це нативний бінарний файл для macOS, Windows і Linux, і AgentsRoom запускає його однаково на всіх трьох. Мобільний застосунок показує ті самі з'єднання та надсилає до них запити лише для читання через ваш комп'ютер.
Чи може AI-агент надсилати запити до бази через проксі?
Так, типово лише для читання. Агент називає збережене з'єднання через AgentsRoom MCP, застосунок сам запускає проксі й виконує команду, а назад повертається лише набір результатів. Агент ніколи не отримує облікові дані Google чи пароль бази, а db_query відхиляє все, крім читання, якщо з'єднання не придатне для запису й ви не ввімкнули для нього «Дозволити агентам запис».
Вам також може сподобатися
З'єднання з базами даних
Зберігайте свої з'єднання з MySQL, PostgreSQL і MongoDB, діставайтеся бази даних у приватній підмережі через SSH-тунель або сесію AWS SSM і дозвольте своїм AI-агентам надсилати до неї запити через MCP. Лише для читання за замовчуванням, одна інструкція на виклик, обмежені набори результатів, і пароль ніколи не потрапляє до агента. Експорт, імпорт і копіювання бази просто в іншу базу теж входять у набір.
RDS через AWS SSM
Дістаньтеся зі своєї машини інстанса Amazon RDS, який не має публічної точки входу, через aws ssm start-session і документ AWS-StartPortForwardingSessionToRemoteHost. Ні бастіона, який треба обслуговувати, ні VPN, ні вхідного правила SSH. AgentsRoom відкриває сесію на loopback-порту і підключає через неї свій клієнт баз даних. MySQL, PostgreSQL і MongoDB, тобто RDS MySQL, RDS PostgreSQL, Aurora і DocumentDB.
Менеджер секретів
Зберігайте API-ключі, токени та паролі в ключовому сховищі вашої ОС, посилайтеся на них як {{secret:NAME}} у командах розробки та середовищах агентів, а AgentsRoom підставить значення під час запуску. Агенти бачать імена, але ніколи не значення, і нічого не надсилається на сервер.
SSH-з'єднання
Зберігайте ваші SSH-з'єднання, відкривайте вбудований термінал через SSH і запускайте Claude Code, Codex або Antigravity CLI безпосередньо на вашому віддаленому сервері або VPS. Аутентифікація за ключем SSH або паролем, профілі з'єднань для кожного проєкту, окремий SSH-клієнт не потрібен.
Надсилайте запити до приватного інстанса Cloud SQL
Завантажте AgentsRoom, виберіть інстанс Cloud SQL і надсилайте до нього запити через Cloud SQL Auth Proxy зі своїм власним входом у gcloud: без бастіон-ВМ, без публічної IP-адреси, без ключа на диску.
Додаток-компаньйон: контролюйте своїх агентів на ходу
Використовуйте свого: Claude, Codex, Antigravity CLI або іншого AI-провайдера.
Надсилайте баги та запити прямо у свій публічний беклог.