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

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

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

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

{% hint style="danger" %}

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

* Изменения вносятся только в конфигурацию основного домена (например, вашдомен.com), а не поддоменов (app.вашдомен.com и т.п.).
* Правка выполняется в разделе **Frontend** в ручной настройке сайта в FastPanel.
* Файлы будут храниться в специальной папке **`static`** в корне сайта и отдаваться напрямую Nginx — без участия SSR или backend.
  {% endhint %}

***

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

{% hint style="warning" %}

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

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

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

{% stepper %}
{% step %}

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

1. В левой панели FastPanel выберите **«Сайты»**.
2. Найдите в списке основной домен (например, **вашдомен.com**) и кликните по нему.

<figure><img src="/files/CVyrmAgSiWPuz6fEzgbJ" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

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

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

<figure><img src="/files/fUPIbZ4rFRideHG6DqAC" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="/files/pmFISoxTRg2Ixu1OlHVi" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

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

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

#### <mark style="color:red;">После</mark>&#x20;

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

#### <mark style="color:green;">Добавьте этот код</mark>

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

{% endstep %}

{% step %}

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

Сохраните изменения.
{% endstep %}
{% endstepper %}

***

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

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

{% stepper %}
{% step %}

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

1. В левой панели FastPanel выберите **«Сайты»**.
2. Найдите в списке основной домен (например, **вашдомен.com**) и кликните по нему.

<figure><img src="/files/CVyrmAgSiWPuz6fEzgbJ" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

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

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

<figure><img src="/files/NkzGFYGqeUob8o5LOJHZ" alt="" width="563"><figcaption></figcaption></figure>

{% endstep %}

{% step %}

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

{% hint style="danger" %}

## Важно!!!

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

Если же папки <mark style="color:red;">**static**</mark> нет, её необходимо создать. Откройте файловый менеджер FastPanel, нажмите кнопку **«Создать папку»** и введите имя static.&#x20;

<figure><img src="/files/JKCVATKo8c2gvQEaIVMk" alt="" width="563"><figcaption></figcaption></figure>

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

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

<figure><img src="/files/VhMlyHkPN4L4i0lQQ3Gk" alt="" width="375"><figcaption></figcaption></figure>

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

{% step %}

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

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

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

<figure><img src="/files/NuumoFi1RdIGKFvwW7pP" alt="" width="563"><figcaption></figcaption></figure>

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

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

{% step %}

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

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

{% hint style="warning" %}

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

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.iexexchanger.com/pomosh-i-spravka/obshie-voprosy/kak-zagruzit-staticheskii-fail.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
