Как загрузить статический файл?

Данная инструкция предназначена для случаев, когда требуется разместить сторонний файл (например, test.txt) в корне сайта, чтобы подтвердить владение доменом или выполнить другую проверку во внешнем сервисе (например, Google Search Console, Яндекс.Вебмастер, системы аналитики, рекламные сети и т.д.).

После настройки вы сможете открыть файл напрямую в браузере по адресу:

https://вашдомен.com/test.txt

Важные особенности

• Изменения вносятся только в конфигурацию основного домена (например, вашдомен.com), а не поддоменов (app.вашдомен.com и т.п.).

• Правка выполняется в разделе Frontend в ручной настройке сайта в FastPanel.

• Файлы будут храниться в специальной папке static в корне сайта и отдаваться напрямую Nginx — без участия SSR или backend.

---

Настройка конфигурации для выдачи статических файлов

Для кого этот раздел:

Эти шаги нужны только в том случае, если ваш сервер ещё не настроен для прямой раздачи файлов из папки /static.

Если конфигурация уже есть — переходите к разделу «Загрузка файла».

1

Открыть настройки сайта

1. В левой панели FastPanel выберите «Сайты».

2. Найдите в списке основной домен (например, вашдомен.com) и кликните по нему.

2

Перейти в ручную настройку

Нажмите «Ручная настройка».

Перейдите во вкладку Frontend.

3

Вставить блоки для прямой выдачи файлов

Найдите место выше редиректов и проксирования, затем добавьте:

После

location ~ ^/(ru|en)$ {
    add_header Set-Cookie "lang=$1; Path=/; Max-Age=31536000; SameSite=Lax";
    return 302 /$1/$is_args$args;
}

Добавьте этот код

# Прямая выдача файлов из папки /static
location ~* ^/(.+\.(?:txt|html|csv|pdf))$ {
    try_files /static/$1 =404;
    add_header Cache-Control "public, max-age=300" always;
    access_log off;
}

4

Применить конфигурацию

Сохраните изменения.

---

Загрузка файла в папку /static

На этом этапе мы поместим нужный файл (например, test.txt) в специальную папку сайта, чтобы он был доступен всем по прямой ссылке в интернете. После загрузки вы сможете открыть его в браузере, введя адрес вида: https://вашдомен.com/test.txt

1

Открыть настройки сайта

1. В левой панели FastPanel выберите «Сайты».

2. Найдите в списке основной домен (например, вашдомен.com) и кликните по нему.

2

Открыть файловый менеджер

В карточке сайта в FastPanel выберите «Файлы».

3

Создать папку static (если нет)

Важно!!!

В корне сайта, то есть в основной директории, где обычно находятся папки dist, logs, а также файл ecosystem.config.cjs, нужно проверить, существует ли папка с именем static. Если вы видите такую папку — дополнительного действия не требуется, просто переходите к следующему шагу.

Если же папки static нет, её необходимо создать. Откройте файловый менеджер FastPanel, нажмите кнопку «Создать папку» и введите имя static.

Имя должно быть написано маленькими буквами, без пробелов и специальных символов.

После создания убедитесь, что у папки есть права, позволяющие веб-серверу читать её содержимое. В большинстве случаев, если вы создаёте папку через FastPanel, нужные права будут выставлены автоматически.

После того как папка создана, откройте её — именно сюда будут загружаться все файлы, которые вы хотите сделать доступными напрямую в браузере.

4

Загрузить файл

Когда папка static уже создана и открыта в файловом менеджере FastPanel, вы можете добавить в неё нужный файл.

Для этого воспользуйтесь кнопкой загрузки — обычно она выглядит как иконка стрелки, направленной вверх.

После нажатия выберите на своём компьютере файл, который хотите разместить на сайте, например test.txt.

Дождитесь, пока загрузка завершится, и убедитесь, что файл появился в списке внутри папки static.

5

Проверить работу

Чтобы убедиться, что файл доступен для просмотра, откройте браузер и введите его адрес в адресную строку. Например, если вы загрузили файл test.txt, ссылка будет выглядеть так: https://вашдомен.com/test.txt

Удаление файла после проверки

Когда внешний сервис (например, Google Search Console) подтвердил владение вашим сайтом, загруженный файл больше не нужен. Рекомендуется сразу удалить его из папки static, чтобы он не был доступен для всех в интернете. Это поможет избежать нежелательного публичного доступа к этому файлу в будущем.