Защо опитните разработчици изоставят localhost:3000 заради истински domain имена

Има нещо особено в мига, когато осъзнаеш, че локалната ти среда за работа не трябва да изглежда като временна играчка.

Миналата седмица показах вътрешен инструмент на колеги. Реакцията дойде веднага, но не за самия инструмент. Всички питаха: "Колко плати за този domain?" Някои мислеха, че съм го купил специално за демото. Други – че имат специален достъп чрез IP.

Истината? Нищо не съм платил. Всичко тичаше локално, но на www.internaltool.com вместо на localhost:3002.

Парадоксът на съвременната разработка

Благодаря на Node.js, Rails и подобни, вградените web сървъри улесниха живота ни. Стартирай с npm start и проектът е онлайн на порт 3000. Без настройки, без сървър.

Но удобството има цена.

Когато работиш с три-четири проекта на портове 3000, 3001, 8080, 5173..., мозъкът ти се превръща в карта на портове. Не мислиш за кода, а за това кой порт къде е. В екип? Хаос.

Най-лошото: локалната ти среда не прилича на production. Там се крият бъговете.

Старият подход, който никога не устаре

Преди фреймуърците да носят свои сървъри, разработчиците ползваха custom domains локално. Свързваха ги чрез системни настройки към реални домейни.

Не беше само за красота. Беше за точна копия на production – директно на твоята машина.

Техниката е проста: hosts файлът на ОС-то плюс reverse proxy като Nginx. Така стартираш проекти на чисти domains – dev.yourproject.com, qa.yourproject.com, дори production URL – всички към различни локални портове.

Резултатът? Професионални URL-и, по-ясна глава, лесно споделяне в екип и среда, която копира production.

Пълен гайд: Custom локални domains

Стъпка 1: Настрой hosts файла

Hosts файлът е твой личен DNS. Компютърът го проверява преди интернет. Добавиш запис и казваш: "За myproject.com – гледай локално".

Къде е файлът:

• macOS/Linux: /etc/hosts
• Windows: C:\Windows\System32\Drivers\etc\hosts

Отвори с редактор (трябва admin/sudo). Добави:

127.0.0.1 myproject.com
127.0.0.1 dev.myproject.com
127.0.0.1 qa.myproject.com

Сега браузърът ще вижда тези domains като 127.0.0.1.

Стъпка 2: Nginx като reverse proxy

Въвеждаш myproject.com – браузърът търси порт 80 (HTTP). Априте ти е на 3000. Не работи.

Nginx слуша на 80 и пренасочва към порта.

Създай/промени Nginx config (обикновено /etc/nginx/sites-available/ на Linux). Добави блокове:

server {
    listen 80;
    server_name myproject.com;

    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

server {
    listen 80;
    server_name dev.myproject.com;

    location / {
        proxy_pass http://localhost:3001;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

server {
    listen 80;
    server_name qa.myproject.com;

    location / {
        proxy_pass http://localhost:3002;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

Рестартирай Nginx:

# macOS
brew services restart nginx

# Linux
sudo systemctl restart nginx

Готово. Отиди на myproject.com – виждаш localhost:3000 през domain.

Про хит: WSL2

На WSL2 Linux има свой IP, различен от Windows. Намери го с:

wsl hostname -I

Ще излезе нещо като 172.x.x.x. Използвай го в Windows hosts вместо 127.0.0.1:

172.x.x.x myproject.com
172.x.x.x dev.myproject.com

Защо това е важно

Изглежда козметика, но е повече.

Първо, съответствие на средите. Локално копираш production архитектурата. Ако ползваш reverse proxy там (трябва), бъговете излизат наяве тук.

Второ, екипна комуникация. Вместо "отвори на порт 3000", казваш "визи dev.internaltool.com". По-ясно, по-малко грешки, по-професионално.

Трето, ясен ум. Без смяна между портове. Domains като в реалния свят.

Най-накрая, отделя те от начинаещи. Професионалистът мисли за средата си.

Умение за цял живот

Този трюк е стар, но удобството го забрави. Удобство ≠ професионализъм.

20 минути за custom domains – най-доброто време в работния ти поток този месец. Основа, която ти позволява да се фокусираш върху софтуера.

Следващия път, когато попитат защо не localhost:3000, кажи: защото мисля като профи.