: Введение | Next.js

Next.js имеет маршрутизатор на основе файловой системы, основанный на концепции страниц.

Когда файл добавляется в каталог страниц , он автоматически становится доступным в качестве маршрута.

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

Указатель маршрутов

Маршрутизатор автоматически направит файлы с именем index в корень каталога.

• стр. / Индекс.js → /
• страниц / блог / index.js → / блог

Вложенные маршруты

Маршрутизатор поддерживает вложенные файлы. Если вы создадите вложенную структуру папок, файлы будут автоматически маршрутизироваться таким же образом.

• страниц / blog / first-post.js → / blog / first-post
• страниц / дашборд / настройки / username.js → / дашборд / настройки / имя пользователя

Сегменты динамического маршрута

Чтобы сопоставить динамический сегмент, вы можете использовать синтаксис скобок.Это позволяет вам сопоставлять именованные параметры.

• страниц / blog / [slug] .js → / blog /: slug ( / blog / hello-world )
• pages / [имя пользователя] /settings.js → /: имя пользователя / настройки ( / foo / settings )
• страниц / post / [... all] .js → / post / * ( / post / 2020 / id / title )

Ознакомьтесь с документацией по динамическим маршрутам, чтобы узнать больше о том, как они работают.

Маршрутизатор Next.js позволяет выполнять переходы маршрута между страницами на стороне клиента, как в одностраничном приложении.

Компонент React под названием Link предоставляется для выполнения этого перехода маршрута на стороне клиента.

  импорт Ссылка из 'next / link'

function Home () {
  возвращение (
    

      

        
           Главная страница 
        
      
      

        
           О нас 
        
      
      

        
           Запись в блоге 
        
      
    
  )
}

экспорт по умолчанию домой
  

В приведенном выше примере у нас есть несколько ссылок, каждая из которых отображает путь ( href ) на известную страницу:

• / → стр. / Индекс.js
• / about → стр. / About.js
• / blog / hello-world → страниц / blog / [slug] .js

Любой в окне просмотра (изначально или через прокрутку) будет предварительно загружен по умолчанию (включая соответствующие данные) для страниц, использующих статическую генерацию. Соответствующие данные для маршрутов, отображаемых сервером, — это , а не , предварительно выбранные.

Связывание с динамическими путями

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

  импорт Ссылка из 'next / link'

function Posts ({posts}) {
  возвращение (
    

      {posts.map ((post) => (
        

          
             {post.title} 
          
        
      ))}
    
  )
}

экспорт сообщений по умолчанию
  

encodeURIComponent используется в примере для обеспечения совместимости пути с utf-8.

В качестве альтернативы, используя объект URL:

  импорт Ссылка из 'next / link'

function Posts ({posts}) {
  возвращение (
    

      {posts.map ((post) => (
        

          <Ссылка
            href = {{
              путь: '/ blog / [slug]',
              запрос: {slug: post.slug},
            }}
          >
             {post.title} 
          
        
      ))}
    
  )
}

экспорт сообщений по умолчанию
  

Теперь вместо использования интерполяции для создания пути мы используем объект URL в href , где:

• путь — это имя страницы в каталоге страниц . / blog / [slug] в данном случае.
• запрос — объект с динамическим сегментом. slug в данном случае.

Для доступа к объекту router в компоненте React вы можете использовать useRouter или withRouter .

Обычно мы рекомендуем использовать useRouter .

Маршрутизатор разделен на несколько частей:

— NuxtJS

Nuxt.js автоматически генерирует конфигурацию vue-router на основе вашего файлового дерева файлов Vue внутри каталога страниц. Когда вы создаете файл .vue в каталоге страниц, у вас будет базовая маршрутизация без дополнительной настройки.

Иногда вам может потребоваться создать динамические маршруты или вложенные маршруты, или вам может потребоваться дополнительная настройка свойства маршрутизатора. В этой главе будет рассмотрено все, что вам нужно знать, чтобы получить максимальную отдачу от вашего маршрутизатора.

Nuxt.js дает вам автоматическое разделение кода для ваших маршрутов, настройка не требуется

  <шаблон>
   Домашняя страница 

  

Основные маршруты

Это дерево файлов:

  стр. /
- | Пользователь/
----- | index.vue
----- | one.vue
- | index.vue
  

автоматически сгенерирует:

  маршрутизатор: {
  маршруты: [
    {
      имя: 'индекс',
      дорожка: '/',
      компонент: 'страницы / index.vue '
    },
    {
      имя: 'пользователь',
      путь: '/ пользователь',
      компонент: 'pages / user / index.vue'
    },
    {
      имя: 'пользователь-один',
      путь: '/ пользователь / один',
      компонент: 'pages / user / one.vue'
    }
  ]
}
  

Динамические маршруты

Иногда невозможно узнать имя маршрута, например, когда мы вызываем API для получения списка пользователей или сообщений в блоге. Мы называем эти маршруты динамическими. Чтобы создать динамический маршрут, вам нужно добавить подчеркивание ( _ ) перед .vue или перед именем каталога. Вы можете назвать файл или каталог как хотите, но вы должны поставить перед ним знак подчеркивания.

Это дерево файлов:

  стр. /
- | _slug /
----- | comments.vue
----- | index.vue
- | пользователи /
----- | _id.vue
- | index.vue
  

автоматически сгенерирует:

  маршрутизатор: {
  маршруты: [
    {
      имя: 'индекс',
      дорожка: '/',
      компонент: 'pages / index.vue'
    },
    {
      имя: 'идентификатор-пользователя',
      путь: '/ users /: id?',
      компонент: 'pages / users / _id.vue '
    },
    {
      имя: 'слизняк',
      путь: '/: slug',
      компонент: 'pages / _slug / index.vue'
    },
    {
      name: 'slug-comments',
      путь: '/: slug / comments',
      компонент: 'pages / _slug / comments.vue'
    }
  ]
}
  

Как вы можете видеть, маршрут с именем user-id имеет путь : id? , что делает его необязательным; если вы хотите сделать это обязательным, вместо этого создайте файл index.vue в каталоге users / _id .

По состоянию на Nuxt> = v2.13 установлен сканер, который теперь будет сканировать ваши теги ссылок и генерировать ваши динамические маршруты на основе этих ссылок. Однако, если у вас есть страницы, которые не связаны, например, секретная страница, вам нужно будет вручную сгенерировать эти динамические маршруты.

Локальный доступ к параметрам маршрута

Вы можете получить доступ к текущим параметрам маршрута на своей локальной странице или в компоненте, указав this. $ Route.params. {ParameterName} . Например, если у вас была динамическая страница пользователей ( пользователей / _id.vue ) и хотели получить доступ к параметру id для загрузки информации о пользователе или процессе, вы могли получить доступ к переменной следующим образом: this. $ route.params.id .

Вложенные маршруты

Nuxt.js позволяет создавать вложенные маршруты, используя дочерние маршруты vue-router. Чтобы определить родительский компонент вложенного маршрута, вам необходимо создать файл Vue с тем же именем, что и каталог, содержащий ваши дочерние представления.

Это дерево файлов:

  стр. /
- | пользователи /
----- | _я бы.vue
----- | index.vue
- | users.vue
  

автоматически сгенерирует:

  маршрутизатор: {
  маршруты: [
    {
      путь: '/ пользователи',
      компонент: 'pages / users.vue',
      дети: [
        {
          дорожка: '',
          компонент: 'pages / users / index.vue',
          имя: 'пользователи'
        },
        {
          путь: ': id',
          компонент: 'pages / users / _id.vue',
          имя: 'идентификатор-пользователя'
        }
      ]
    }
  ]
}
  

Динамические вложенные маршруты

Это не распространенный сценарий, но он возможен с Nuxt.js, чтобы иметь динамических детей внутри динамических родителей.

Это дерево файлов:

  стр. /
- | _category /
----- | _подкатегория/
-------- | _id.vue
-------- | index.vue
----- | _subCategory.vue
----- | index.vue
- | _category.vue
- | index.vue
  

автоматически сгенерирует:

  маршрутизатор: {
  маршруты: [
    {
      дорожка: '/',
      компонент: 'pages / index.vue',
      имя: 'индекс'
    },
    {
      путь: '/: категория',
      компонент: 'pages / _category.vue ',
      дети: [
        {
          дорожка: '',
          компонент: 'pages / _category / index.vue',
          имя: 'категория'
        },
        {
          путь: ': подкатегория',
          компонент: 'pages / _category / _subCategory.vue',
          дети: [
            {
              дорожка: '',
              компонент: 'pages / _category / _subCategory / index.vue',
              имя: 'категория-подкатегория'
            },
            {
              путь: ': id',
              компонент: 'pages / _category / _subCategory / _id.vue ',
              имя: 'идентификатор-подкатегории-категории'
            }
          ]
        }
      ]
    }
  ]
}
  

Неизвестные динамические вложенные маршруты

Если вам неизвестна глубина структуры URL-адреса, вы можете использовать _.vue для динамического сопоставления вложенных путей. Это будет обрабатывать запросы, которые не соответствуют более конкретному маршруту .

Это дерево файлов:

  стр. /
- | люди/
----- | _id.vue
----- | index.vue
- | _.vue
- | index.vue
  

Будет обрабатывать такие запросы:

  / -> index.vue
/ люди -> люди / index.vue
/ люди / 123 -> люди / _id.vue
/ о -> _.vue
/ о компании / карьера -> _.vue
/ о компании / карьера / чикаго -> _.vue
  

Обработка страниц 404 теперь соответствует логике страницы _.vue .

Удлинитель маршрутизатора

Есть несколько способов расширить маршрутизацию с помощью Nuxt:

Свойство маршрутизатора

Свойство router позволяет настроить маршрутизатор Nuxt.js (vue-router).

  экспорт по умолчанию {
  router: {
    
  }
}
  

База:

Базовый URL-адрес приложения.Например, если все одностраничное приложение обслуживается под / app / , тогда base должно использовать значение '/ app /' .

extendRoutes

Вы можете захотеть расширить маршруты, созданные Nuxt.js. Вы можете сделать это с помощью опции extendRoutes .

Пример добавления произвольного маршрута:

  экспорт по умолчанию {
  router: {
    extendRoutes (routes, resolve) {
      routes.push ({
        имя: 'обычай',
        дорожка: '*',
        компонент: resolve (__ dirname, 'pages / 404.vue ')
      })
    }
  }
}
  

Если вы хотите отсортировать свои маршруты, вы можете использовать функцию sortRoutes (routes) из @ nuxt / utils :

  импортировать {sortRoutes} из '@ nuxt / utils'
экспорт по умолчанию {
  router: {
    extendRoutes (routes, resolve) {
      

      
      sortRoutes (маршруты)
    }
  }
}
  

Схема маршрута должна соответствовать схеме vue-router.

При добавлении маршрутов, использующих именованные представления, не забудьте добавить соответствующие chunkNames из именованных компонентов .

  экспорт по умолчанию {
  router: {
    extendRoutes (routes, resolve) {
      routes.push ({
        путь: '/ пользователи /: id',
        компоненты: {
          по умолчанию: resolve (__ dirname, 'pages / users'),
          модальный: решить (__ dirname, 'components / modal.vue')
        },
        chunkNames: {
          модальный: 'компоненты / модальный'
        }
      })
    }
  }
}
  

резерв

Определяет, должен ли маршрутизатор перейти в режим хеширования, если браузер не поддерживает историю.pushState, но установлен режим истории.

режим

Настройте режим роутера, менять его не рекомендуется из-за рендеринга на стороне сервера.

parseQuery / stringifyQuery

Предоставляет пользовательские функции синтаксического анализа / преобразования строки запроса.

routeNameSplitter

Вы можете изменить разделитель между именами маршрутов, которые использует Nuxt.js. Это можно сделать с помощью параметра routeNameSplitter в файле конфигурации. Представьте, что у нас есть файл подкачки pages / posts / _id.vue . Nuxt.js сгенерирует имя маршрута программно, в данном случае posts-id . Изменив конфигурацию routeNameSplitter на /, имя изменится на сообщений / идентификатор .

  экспорт по умолчанию {
  router: {
    routeNameSplitter: '/'
  }
}
  

scrollBehavior

Параметр scrollBehavior позволяет определить настраиваемое поведение для позиции прокрутки между маршрутами. Этот метод вызывается каждый раз при отображении страницы.

Доступно с версии: v2.9.0:

В Nuxt.js вы можете использовать файл для перезаписи scrollBehavior маршрутизатора. Этот файл следует поместить в папку с именем app.

~ / приложение / router.scrollBehavior.js .

Пример принудительного перемещения позиции прокрутки вверх для каждого маршрута:

  экспорт функции по умолчанию (в, из, сохраненное положение) {
  вернуть {x: 0, y: 0}
}
  

завершающая косая черта

Доступно с: v2.10

Если для этого параметра установлено значение true, завершающие косые черты будут добавлены к каждому маршруту. Если установлено значение false, они будут удалены.

  экспорт по умолчанию {
  router: {
    trailingSlash: истина
  }
}
  

Этот параметр не следует устанавливать без подготовки и должен быть тщательно протестирован. При установке router.trailingSlash на другое значение, кроме undefined (значение по умолчанию), противоположный маршрут перестанет работать.Таким образом, 301 редирект должен быть на месте, и ваша внутренняя ссылка должна быть адаптирована правильно. Если вы установите trailingSlash на true , тогда будет работать только example.com/abc/ , но не example.com/abc . На false все наоборот.

больших приложений — несколько файлов

Если вы создаете приложение или веб-API, редко бывает так, что вы можете поместить все в один файл.

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

Информация

Если вы пришли из Flask, это будет эквивалент Flask’s Blueprints.

Пример файловой структуры

Допустим, у вас есть такая файловая структура:

 .
├── приложение
│ ├── __init__.py
│ ├── main.py
│ ├── dependencies.py
│ └── роутеры
│ │ ├── __init__.py
│ │ ├── items.py
│ │ └── users.py
│ └── внутренний
│ ├── __init__.py
│ └── admin.py
  

Подсказка

Есть несколько __init__.py : по одному в каждом каталоге или подкаталоге.

Это то, что позволяет импортировать код из одного файла в другой.

Например, в app / main.py у вас может быть такая строка:

  из app.routers import items
  

• Каталог приложения содержит все. И у него есть пустой файл app / __ init__.py , так что это «пакет Python» (набор «модулей Python»): app .
• Он содержит app / main.py файл. Поскольку он находится внутри пакета Python (каталог с файлом __init__.py ), он является «модулем» этого пакета: app.main .
• Также есть файл app / dependencies.py , как и app / main.py , это «модуль»: app.dependencies .
• Есть подкаталог app / routers / с другим файлом __init__.py , так что это «подпакет Python»: app.routers .
• Файл app / routers / items.py находится внутри пакета, app / routers / , так что это подмодуль: app.routers.items .
• То же самое с app / routers / users.py , это еще один подмодуль: app.routers.users .
• Также есть подкаталог app / internal / с другим файлом __init__.py , так что это еще один «подпакет Python»: app.internal .
• И файл app / internal / admin.py — это еще один подмодуль: app.internal.admin .

Та же файловая структура с комментариями:

 .
├── app # "app" - это пакет Python
│ ├── __init__.py # этот файл делает "app" "пакетом Python"
│ ├── main.py # "главный" модуль, например import app.main
│ ├── dependencies.py # модуль "зависимости", например импортировать app.dependencies
│ └── routers # "routers" - это "подпакет Python"
│ │ ├── __init__.py # делает "маршрутизаторы" "подпакетом Python"
│ │ ├── предметы.py # подмодуль "items", например импортировать app.routers.items
│ │ └── users.py # подмодуль "пользователи", например импортировать app.routers.users
│ └── internal # "internal" - это "подпакет Python"
│ ├── __init__.py # делает "internal" "подпакетом Python"
│ └── admin.py # подмодуль "admin", например импортировать app.internal.admin
  

Допустим, файл, предназначенный только для работы с пользователями, — это подмодуль /app/routers/users.py .

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

Но он по-прежнему является частью того же приложения / веб-API FastAPI (он является частью того же «Пакета Python»).

Вы можете создать операции пути для этого модуля с помощью APIRouter .

Импорт

Вы импортируете его и создаете «экземпляр» так же, как и с классом FastAPI :

  из fastapi import APIRouter

router = APIRouter ()


@router.get ("/ users /", tags = ["users"])
async def read_users ():
    return [{"username": "Rick"}, {"username": "Morty"}]


@ router.get ("/ users / me", tags = ["users"])
async def read_user_me ():
    return {"username": "fakecurrentuser"}


@ router.get ("/ users / {username}", tags = ["users"])
async def read_user (имя пользователя: str):
    return {"username": username}
  

И затем вы используете его для объявления своих операций пути .

Используйте его так же, как и класс FastAPI :

  из fastapi import APIRouter

router = APIRouter ()


@ router.get ("/ users /", tags = ["users"])
async def read_users ():
    return [{"username": "Rick"}, {"username": "Morty"}]


@ router.get ("/ users / me", tags = ["users"])
async def read_user_me ():
    return {"username": "fakecurrentuser"}


@ router.get ("/ users / {username}", tags = ["users"])
async def read_user (имя пользователя: str):
    return {"username": username}
  

Вы можете думать о APIRouter как о классе «mini FastAPI ».

Поддерживаются все те же опции.

Все равно параметров , ответов , зависимостей , тегов и т.д.

Подсказка

В этом примере переменная называется router , но вы можете назвать ее как хотите.

Мы собираемся включить этот APIRouter в основное приложение FastAPI , но сначала давайте проверим зависимости и еще один APIRouter .

Зависимости

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

Итак, мы поместили их в собственный модуль dependencies ( app / dependencies.py ).

Теперь мы будем использовать простую зависимость для чтения настраиваемого заголовка X-Token :

  из заголовка импорта fastapi, HTTPException


async def get_token_header (x_token: str = Header (...)):
    если x_token! = "поддельный суперсекретный токен":
        поднять HTTPException (status_code = 400, detail = "Недействительный заголовок X-Token")


async def get_query_token (токен: str):
    если токен! = "jessica":
        поднять HTTPException (status_code = 400, detail = "Токен Джессики не предоставлен")
  

Подсказка

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

Но в реальных случаях вы получите лучшие результаты, используя встроенные утилиты безопасности.

Другой модуль с

Допустим, у вас также есть конечные точки, предназначенные для обработки «элементов» из вашего приложения в модуле по адресу app / routers / items.py .

У вас есть операций с путями для:

Все та же структура, что и у app / routers / users.py .

Но мы хотим быть умнее и немного упростить код.

Мы знаем, что все операции пути в этом модуле совпадают:

• Путь , префикс : / items .
• тегов : (всего один тег: элементов ).
• Экстра ответов .
• зависимостей : им всем нужна созданная нами зависимость X-Token .

Итак, вместо того, чтобы добавлять все это к каждой операции пути , мы можем добавить ее к APIRouter .

  из fastapi import APIRouter, Depends, HTTPException

from ..dependencies import get_token_header

router = APIRouter (
    prefix = "/ items",
    tags = ["items"],
    dependencies = [Зависит (get_token_header)],
    response = {404: {"description": "Not found"}},
)


fake_items_db = {"plumbus": {"name": "Plumbus"}, "gun": {"name": "Portal Gun"}}


@ router.get ("/")
async def read_items ():
    вернуть fake_items_db


@ router.get ("/ {item_id}")
async def read_item (item_id: str):
    если item_id не в fake_items_db:
        поднять HTTPException (status_code = 404, detail = "Элемент не найден")
    вернуть {"name": fake_items_db [item_id] ["name"], "item_id": item_id}


@router.положил(
    "/ {item_id}",
    tags = ["custom"],
    response = {403: {"description": "Операция запрещена"}},
)
async def update_item (item_id: str):
    если item_id! = "отвес":
        поднять HTTPException (
            status_code = 403, detail = "Вы можете обновить только элемент: plumbus"
        )
    return {"item_id": item_id, "name": "Великий Плюмбус"}
  

Поскольку путь каждой операции пути должен начинаться с /, как в:

  @ router.get ("/ {item_id}")
async def read_item (item_id: str):
    ...
  

… префикс не должен включать окончательные /.

Итак, префикс в данном случае — / items .

Мы также можем добавить список из тегов и дополнительных ответов , которые будут применяться ко всем операциям пути , включенным в этот маршрутизатор.

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

Конечным результатом является то, что пути к элементам теперь:

… как мы и предполагали.

• Они будут отмечены списком тегов, содержащих одну строку «items» .
  • Эти «теги» особенно полезны для систем автоматической интерактивной документации (с использованием OpenAPI).
• Все они будут включать предопределенные ответов .
• Все эти операции пути будут иметь список из зависимостей , оцененных / выполненных перед ними.

Подсказка

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

Чек

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

Импортировать зависимости

Этот код находится в модуле app.routers.items , файле app / routers / items.py .

И нам нужно получить функцию зависимости от модуля app.dependencies , файла app / dependencies.py .

Итак, мы используем относительный импорт с .. для зависимостей:

  из fastapi import APIRouter, Depends, HTTPException

from ..dependencies import get_token_header

router = APIRouter (
    prefix = "/ items",
    tags = ["items"],
    dependencies = [Зависит (get_token_header)],
    response = {404: {"description": "Not found"}},
)


fake_items_db = {"plumbus": {"name": "Plumbus"}, "gun": {"name": "Portal Gun"}}


@router.получать("/")
async def read_items ():
    вернуть fake_items_db


@ router.get ("/ {item_id}")
async def read_item (item_id: str):
    если item_id не в fake_items_db:
        поднять HTTPException (status_code = 404, detail = "Элемент не найден")
    вернуть {"name": fake_items_db [item_id] ["name"], "item_id": item_id}


@ router.put (
    "/ {item_id}",
    tags = ["custom"],
    response = {403: {"description": "Операция запрещена"}},
)
async def update_item (item_id: str):
    если item_id! = "отвес":
        поднять HTTPException (
            status_code = 403, detail = "Вы можете обновить только элемент: plumbus"
        )
    return {"item_id": item_id, "name": "Великий Плюмбус"}
  

Как работает относительный импорт

Подсказка

Если вы прекрасно знаете, как работает импорт, переходите к следующему разделу ниже.

Одна точка . , как в:

  из .dependencies import get_token_header
  

будет означать:

• Начиная с того же пакета, в котором находится этот модуль (файл app / routers / items.py ) (каталог app / routers / ) …
• найдите модуль dependencies (воображаемый файл по адресу app / routers / dependencies.py ) …
• и из него импортировать функцию get_token_header .

Но этого файла не существует, наши зависимости находятся в файле по адресу app / dependencies.py .

Вспомните, как выглядит наша структура приложения / файла:

Две точки .. , как в:

  из ..dependencies import get_token_header
  

означает:

• Начиная с того же пакета, в котором находится этот модуль (файл app / routers / items.py ) (каталог app / routers / )…
• перейти к родительскому пакету (каталог app / ) …
• и там найдите модуль dependencies (файл в app / routers / dependencies.py ) …
• и из него импортировать функцию get_token_header .

Работает правильно! 🎉

Так же, если бы мы использовали три точки ... , как в:

  из ... зависимости import get_token_header
  

, что будет означать:

• Запускается в том же пакете, что и этот модуль (файл app / routers / items.py ) живет в (директория app / routers / ) …
• перейти к родительскому пакету (каталог app / ) …
• затем перейдите к родительскому пакету (родительского пакета нет, приложение , — это верхний уровень 😱) …
• и там найдите модуль dependencies (файл в app / routers / dependencies.py ) …
• и из него импортировать функцию get_token_header .

Это относится к некоторому пакету выше app / с собственным файлом __init__.py и т. д. Но у нас этого нет. Итак, в нашем примере это вызовет ошибку. 🚨

Но теперь вы знаете, как это работает, поэтому вы можете использовать относительный импорт в своих собственных приложениях, независимо от их сложности. 🤓

Добавьте несколько настраиваемых тегов

Мы не добавляем префикс / items или tags = ["items"] к каждой операции пути , потому что мы добавили их в APIRouter .

Но мы все еще можем добавить еще тегов , которые будут применяться к определенной операции пути , а также некоторые дополнительные ответы , относящиеся к этой операции пути :

  из fastapi import APIRouter, Depends, HTTPException

from ..dependencies import get_token_header

router = APIRouter (
    prefix = "/ items",
    tags = ["items"],
    dependencies = [Зависит (get_token_header)],
    response = {404: {"description": "Not found"}},
)


fake_items_db = {"plumbus": {"name": "Plumbus"}, "gun": {"name": "Portal Gun"}}


@router.получать("/")
async def read_items ():
    вернуть fake_items_db


@ router.get ("/ {item_id}")
async def read_item (item_id: str):
    если item_id не в fake_items_db:
        поднять HTTPException (status_code = 404, detail = "Элемент не найден")
    вернуть {"name": fake_items_db [item_id] ["name"], "item_id": item_id}


@ router.put (
    "/ {item_id}",
    tags = ["custom"],
    response = {403: {"description": "Операция запрещена"}},
)
async def update_item (item_id: str):
    если item_id! = "отвес":
        поднять HTTPException (
            status_code = 403, detail = "Вы можете обновить только элемент: plumbus"
        )
    return {"item_id": item_id, "name": "Великий Плюмбус"}
  

Подсказка

Эта последняя операция пути будет иметь комбинацию тегов: ["items", "custom"] .

И он также будет иметь оба ответа в документации, один для 404 и один для 403 .

Основной

Теперь давайте посмотрим на модуль app / main.py .

Здесь вы импортируете и используете класс FastAPI .

Это будет главный файл в вашем приложении, который связывает все воедино.

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

Импорт

Вы импортируете и создаете класс FastAPI как обычно.

И мы даже можем объявить глобальные зависимости, которые будут объединены с зависимостями для каждого APIRouter :

  из fastapi import Depends, FastAPI

из .dependencies import get_query_token, get_token_header
из .internal import admin
из .routers импортировать элементы, пользователи

app = FastAPI (зависимости = [Depends (get_query_token)])


приложение.include_router (users.router)
app.include_router (items.router)
app.include_router (
    admin.router,
    префикс = "/ админ",
    теги = ["админ"],
    dependencies = [Зависит (get_token_header)],
    response = {418: {"description": "Я чайник"}},
)


@ app.get ("/")
async def root ():
    return {"message": "Здравствуйте, большие приложения!"}
  

Импорт

Теперь мы импортируем другие подмодули с APIRouter s:

  из fastapi import Depends, FastAPI

из .зависимости import get_query_token, get_token_header
из .internal import admin
из .routers импортировать элементы, пользователи

app = FastAPI (зависимости = [Depends (get_query_token)])


app.include_router (users.router)
app.include_router (items.router)
app.include_router (
    admin.router,
    префикс = "/ админ",
    теги = ["админ"],
    dependencies = [Зависит (get_token_header)],
    response = {418: {"description": "Я чайник"}},
)


@ app.get ("/")
async def root ():
    return {"message": "Здравствуйте, большие приложения!"}
  

В виде файлов app / routers / users.py и app / routers / items.py — это подмодули, которые являются частью одного пакета Python app , мы можем использовать одну точку . , чтобы импортировать их с помощью «относительного импорта».

Как работает импорт

Раздел:

  из .routers import items, users
  

означает:

• Запускается в том же пакете, в котором находится этот модуль (файл app / main.py ) (каталог app / )…
• найдите подпакет router (каталог в app / routers / ) …
• и из него импортируйте подмодуль items (файл в app / routers / items.py ) и users (файл в app / routers / users.py ) …

Модуль items будет иметь переменный маршрутизатор ( items.router ). Это тот же объект, который мы создали в файле app / routers / items.py , это объект APIRouter .

А потом делаем то же самое для модуля пользователей .

Мы также можем импортировать их, например:

  из app.routers импортировать элементы, пользователи
  

Информация

Первая версия — «относительный импорт»:

  из .routers import items, users
  

Вторая версия — «абсолютный импорт»:

  из app.routers импортировать элементы, пользователи
  

Чтобы узнать больше о пакетах и ​​модулях Python, прочтите официальную документацию Python о модулях.

Избегайте конфликтов имен

Мы импортируем подмодуль , элементы напрямую, вместо того, чтобы импортировать только его переменную router .

Это связано с тем, что у нас также есть другая переменная с именем router в подмодуле users .

Если бы мы импортировали один за другим, например:

  из импортного маршрутизатора .routers.items
из .routers.users импортировать роутер
  

Маршрутизатор от пользователей перезапишет маршрутизатор из пунктов , и мы не сможем использовать их одновременно.

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

  из fastapi import Depends, FastAPI

из .dependencies import get_query_token, get_token_header
из .internal import admin
из .routers импортировать элементы, пользователи

app = FastAPI (зависимости = [Depends (get_query_token)])


app.include_router (users.router)
app.include_router (items.router)
app.include_router (
    admin.router,
    префикс = "/ админ",
    теги = ["админ"],
    dependencies = [Зависит (get_token_header)],
    response = {418: {"description": "Я чайник"}},
)


@приложение.получать("/")
async def root ():
    return {"message": "Здравствуйте, большие приложения!"}
  

Включите

Теперь давайте включим маршрутизатор s из подмодулей пользователей и элементов :

  из fastapi import Depends, FastAPI

из .dependencies import get_query_token, get_token_header
из .internal import admin
из .routers импортировать элементы, пользователи

app = FastAPI (зависимости = [Depends (get_query_token)])


приложение.include_router (users.router)
app.include_router (items.router)
app.include_router (
    admin.router,
    префикс = "/ админ",
    теги = ["админ"],
    dependencies = [Зависит (get_token_header)],
    response = {418: {"description": "Я чайник"}},
)


@ app.get ("/")
async def root ():
    return {"message": "Здравствуйте, большие приложения!"}
  

Информация

users.router содержит APIRouter внутри файла app / routers / users.py .

и шт.router содержит APIRouter внутри файла app / routers / items.py .

С помощью app.include_router () мы можем добавить каждый APIRouter в основное приложение FastAPI .

Он будет включать в себя все маршруты от этого маршрутизатора.

Технические характеристики

Фактически он внутренне создает операцию пути для каждой операции пути , которая была объявлена ​​в APIRouter .

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

Чек

Вам не нужно беспокоиться о производительности при включении маршрутизаторов.

Это займет микросекунды и произойдет только при запуске.

Так что это не повлияет на производительность. ⚡

Включить

Теперь представим, что ваша организация предоставила вам app / internal / admin.py файл.

Он содержит APIRouter с некоторыми операциями пути администратора , которые ваша организация разделяет между несколькими проектами.

Для этого примера это будет очень просто. Но предположим, что, поскольку он используется совместно с другими проектами в организации, мы не можем изменить его и добавить префикс , зависимости , теги и т. Д. Непосредственно в APIRouter :

  из fastapi import APIRouter

router = APIRouter ()


@router.Почта("/")
async def update_admin ():
    return {"message": "Админ становится хитрым"}
  

Но мы по-прежнему хотим установить собственный префикс при включении APIRouter , чтобы все его операции пути начинались с / admin , мы хотим защитить его с помощью зависимостей , которые у нас уже есть для этого проекта, и мы хотим включить тегов и ответов .

Мы можем объявить все это, не изменяя исходный APIRouter , передав эти параметры в приложение .include_router () :

  из fastapi import Depends, FastAPI

из .dependencies import get_query_token, get_token_header
из .internal import admin
из .routers импортировать элементы, пользователи

app = FastAPI (зависимости = [Depends (get_query_token)])


app.include_router (users.router)
app.include_router (items.router)
app.include_router (
    admin.router,
    префикс = "/ админ",
    теги = ["админ"],
    dependencies = [Зависит (get_token_header)],
    response = {418: {"description": "Я чайник"}},
)


@приложение.получать("/")
async def root ():
    return {"message": "Здравствуйте, большие приложения!"}
  

Таким образом, исходный APIRouter останется неизменным, так что мы все равно сможем поделиться тем же файлом app / internal / admin.py с другими проектами в организации.

В результате в нашем приложении каждая из операций пути из модуля admin будет иметь:

• Префикс / admin .
• Тег admin .
• Зависимость get_token_header .
• Ответ 418 . 🍵

Но это повлияет только на APIRouter в нашем приложении, а не на какой-либо другой код, который его использует.

Так, например, другие проекты могут использовать тот же APIRouter с другим методом аутентификации.

Включить операцию пути

Мы также можем добавить операцию пути непосредственно в приложение FastAPI .

Вот и сделаем … просто чтобы показать, что мы можем 🤷:

  из fastapi import Depends, FastAPI

из .dependencies import get_query_token, get_token_header
из .internal import admin
из .routers импортировать элементы, пользователи

app = FastAPI (зависимости = [Depends (get_query_token)])


app.include_router (users.router)
app.include_router (items.router)
app.include_router (
    admin.router,
    префикс = "/ админ",
    теги = ["админ"],
    dependencies = [Зависит (get_token_header)],
    response = {418: {"description": "Я чайник"}},
)


@приложение.получать("/")
async def root ():
    return {"message": "Здравствуйте, большие приложения!"}
  

, и он будет работать правильно вместе со всеми другими операциями пути , добавлен с помощью app.include_router () .

Очень технические детали

Примечание : это очень техническая деталь, которую вы, вероятно, можете пропустить , просто пропустив .

APIRouter не «смонтированы», они не изолированы от остальной части приложения.

Это потому, что мы хотим включить их операции пути в схему OpenAPI и пользовательские интерфейсы.

Поскольку мы не можем просто изолировать их и «смонтировать» независимо от остальных, операции пути «клонируются» (воссоздаются), а не включаются напрямую.

Проверить автоматические документы API

Теперь запустите uvicorn , используя модуль app.main и переменную app :

  $ uvicorn app.main: app --reload

 ИНФОРМАЦИЯ : Uvicorn работает на http://127.0.0.1:8000 (для выхода нажмите CTRL + C)
  

И откройте документы по адресу http://127.0.0.1:8000/docs.

Вы увидите автоматические документы API, включая пути от всех подмодулей, с использованием правильных путей (и префиксов) и правильных тегов:

Включите один и тот же маршрутизатор несколько раз с разным префиксом

Вы также можете использовать .include_router () несколько раз с тем же маршрутизатором , используя разные префиксы.

Это может быть полезно, например, для предоставления одного и того же API с разными префиксами, например / api / v1 и / api / последняя версия .

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

Включить

Таким же образом вы можете включить APIRouter в приложение FastAPI , вы можете включить APIRouter в другой APIRouter , используя:

  роутер.include_router (другой_роутер)
  

Убедитесь, что вы сделали это, прежде чем включать router в приложение FastAPI , чтобы также были включены операции path из other_router .

10 команд управления файлами маршрутизатора Cisco IOS, которые вы должны знать

Дэвид Дэвис перебирает команды Cisco IOS, которые вы должны знать для управления файлами на флеш-памяти маршрутизатора Cisco, NVRAM или других файловых системах, что позволяет создавать резервные копии вашей конфигурации, обновлять маршрутизатор или просто поддерживать файловую систему IOS.

Как и операционная система Windows или Linux, Cisco IOS имеет собственный список команд для управления файлами, очень похожий на команды DOS / Windows. Эти файлы могут быть вашей операционной системой маршрутизатора IOS, файлом конфигурации или файлом IOS другого типа. Знание этих файловых команд является критическим требованием для любого администратора Cisco.

Давайте рассмотрим 10 команд управления файлами Cisco IOS, которые вам необходимо знать.

Показывает список каталогов файлов в файловой системе.Чтобы увидеть варианты, введите dir?

 Router # dir? 

 / все Список всех файлов 

 / рекурсивный список файлов рекурсивно 

 all-filesystems Список файлов во всех файловых системах 

: каталог или имя файла 

 cns: каталог или имя файла 

 flash: каталог или имя файла 

 null: Имя каталога или файла 

 nvram: каталог или имя файла 

: каталог или имя файла 

 tar: каталог или имя файла 

 tmpsys: каталог или имя файла 

 xmodem: каталог или имя файла 

 ymodem: каталог или имя файла 

 Маршрутизатор # 

 Маршрутизатор # dir 

 Каталог флеш-памяти: / 

 2 -rwx 18929780 29 августа 2006 г. 15:49:57 +00: 00 c870-advipservicesk9-mz.124-15.T5.bin 

 3 -rwx 2143 29 августа 2006 г. 16:42:14 +00: 00 running-config 

 23482368 байт всего (4544512 байт свободно) 

 Маршрутизатор # 

Каждый маршрутизатор должен иметь как минимум флэш-память и NVRAM (энергонезависимую память с произвольным доступом).

Изменить каталог: используйте cd , чтобы изменить текущий каталог на другое устройство или подкаталог на этом устройстве. Далее, когда я меняю свой каталог на файловую систему nvram: и делаю dir , , я получаю список nvram. Я мог бы также cd в подкаталог после того, как я создал каталог с mkdir .

 # cd nvram: 

 Маршрутизатор # dir 

 Каталог NVRAM: / 

126 -rw- 2143 <без даты> конфигурация запуска 

127 ---- 5 <без даты> private-config 

 128 -rw- 2143 <без даты> базовая конфигурация 

 1 ---- 49 <без даты> постоянные данные 

 2 -rw- 0 <без даты> ifIndex-table 

 Всего 131072 байта (116584 байта свободно) 

 Маршрутизатор # 

Используется для копирования IOS или файла конфигурации откуда-нибудь и куда-нибудь.Вы могли бы использовать это, чтобы скопировать конфигурацию маршрутизатора с маршрутизатора на сервер TFTP или просто сделать ее локальную резервную копию на маршрутизаторе. Вы также можете использовать команду copy для обновления маршрутизатора с новым IOS с сервера TFTP.

Здесь я делаю локальную резервную копию текущей конфигурации маршрутизатора:

 # copy running-config davids-backup-before-upgrade 

 Целевое имя файла [davids-backup-before-upgrade]? 

 2181 байт скопировано в 3.052 сек (715 байт / сек) 

 Маршрутизатор # 

 # удалить davids-backup-before-upgrade 

 Удалить имя файла [davids-backup-before-upgrade]? 

 Удалить флэш-память: / davids-backup-before-upgrade? [подтвердить] 

 Маршрутизатор # 

 Маршрутизатор # показать флэш-память 

 24576 Кбайт процессорной платы Системная флэш-память (Intel Strataflash) 

 Каталог флеш-памяти: / 

 2 -rwx 18929780 29 августа 2006 г. 15:49:57 +00: 00 c870-advipservicesk9-mz.124-15.T5.bin 

 3 -rwx 2181 4 октября 2006 г. 04:03:00 +00: 00 mybackup-today 

 23482368 байт всего (4544512 байт свободно) 

 Маршрутизатор # 

Может быть немного непонятно, почему стирает один тип файловой системы, а формат другой.Что вам действительно нужно знать, так это то, что вы форматируете флеш-устройства и стираете NVRAM. Существуют и другие типы файловых систем, и вы можете стереть или отформатировать их в зависимости от их типа. Команда erase чаще всего используется, когда вы хотите стереть конфигурацию маршрутизатора и начать с конфигурации по умолчанию. Это делается с помощью команды erase startup-configuration .

 Маршрутизатор # стереть? 

 / all Удалить все файлы (в NVRAM) 

 / no-squeeze-reserve-space Не резервировать место для операции сжатия 

 flash: Файловая система для удаления 

 nvram: файловая система для удаления 

 startup-config Удалить содержимое памяти конфигурации 

 Router # format? 

 flash: файловая система для форматирования 

 Маршрутизатор # 

 Маршрутизатор # подробнее my-backup-config 

! 

 версия 12.4 

 интерфейс кэша конфигурации парсера 

 интерфейс конфигурации парсера 

 {конфигурация усечена} 

Используется для проверки контрольной суммы или вычисления подписи MD5 для файла.

 Маршрутизатор # verify flash: c870-advipservicesk9-mz.124-15.T5.bin 

 Проверка целостности файла флэш-памяти: c870-advipservicesk9-mz.124-15.T5.bin ....... {усечено} ............ Готово! 

 Встроенный хэш MD5: CA8AEC573B197AEC6BD5892DE23C4754 

 Вычисленный хэш MD5: CA8AEC573B197AEC6BD5892DE23C4754 

 CCO Хэш MD5: 9D39672246853C0F31533B6BCB21DFE5 

 Проверка встроенного хэша прошла успешно. 

 Ошибка проверки хэша файловой системы для флэш-файла: c870-advipservicesk9-mz.124-15.T5.bin (Нет такого файла или каталога).

 Маршрутизатор # 

Как и в DOS, вы используете mkdir для создания каталога / папки. Я бы сделал это, возможно, чтобы создать папку архива для резервных копий конфигураций или старых файлов IOS.

 Маршрутизатор # mkdir backup-config 

 Создать каталог с именем файла [резервные копии]? 

 Создан dir flash: backup-config 

 Маршрутизатор # 

Проверка файловой системы FAT обычно используется для проверки целостности файловой системы флэш-памяти.Вы можете сделать это, если испытали некоторое повреждение файлов IOS во флэш-памяти.

 Маршрутизатор # fsck 

 Операция Fsck может занять некоторое время. Продолжать? [подтвердить] 

 ..... {усечено} ....... 

 Количество вспышек: полное 

 Маршрутизатор # 

Хотя существует так много причин для использования подобных команд файловой системы, если бы мне пришлось выбрать три наиболее практичных применения некоторых из перечисленных выше команд, вот мой список:

1. Навигация по файловым системам Cisco IOS — зная, какие файлы конфигурации и какие файлы IOS находятся на маршрутизаторе, возможно, перед выполнением обновления.
2. Создайте резервную копию конфигурации на локальном маршрутизаторе или отключите ее на сервере TFTP, возможно, перед резервным копированием
3. Выполнение обновления Cisco IOS путем копирования IOS с сервера TFTP на маршрутизатор.

Очень важно понимать команды управления файлами IOS, что это за команды и как их можно использовать в реальном мире. Вы же не хотите запутаться, чтобы восстановить свою IOS, когда основная IOS повреждена!

Нужна помощь в настройке, администрировании, поддержке и оптимизации сетевой инфраструктуры? Тогда обратитесь к нашему бесплатному NetNote сетевого администрирования.Зарегистрируйтесь автоматически сегодня!

— Загрузите программное обеспечение и прошивку

Timemachine с X в названии продукта (например, Pro XWR, Club XR и т. Д.) Имеют встроенный сетевой маршрутизатор.
Важно убедиться, что на этом маршрутизаторе установлена ​​последняя версия микропрограммы, чтобы гарантировать, что сетевое соединение с вашим считывателем не потеряно.

Порядок проверки версии прошивки роутера

1. Включите считыватель
2. Подключение через LAN кабель к ПК
3. Перейдите по адресу http: // 192.168.0.1 (или другой адрес, если вы меняли адрес в роутере)
4. При запросе пароля используйте по умолчанию admin / admin
5. Щелкните «Системные настройки»
6. Проверьте «Версия программного обеспечения» (вверху страницы). Новая прошивка — V7209.5. Если версия отличается (например, V7209.3), то требуется обновление прошивки.
   

Для обновления прошивки:

Загрузите новый файл прошивки Trident_V7209_5.uImage и сохраните его на свой компьютер

1. Включите считыватель
2. Подключение через LAN кабель к ПК
3. Перейдите по адресу http: // 192.168.0.1 (или другой адрес, если вы меняли адрес в роутере)
4. При запросе пароля используйте по умолчанию admin / admin
5. Щелкните Системные настройки
6. Слева нажмите Управление
7. Нажмите «Обновление прошивки»
8. Нажмите, чтобы выбрать файл
9. Выберите файл Trident_V7209_5.uImage, который вы сохранили на свой компьютер на шаге 1, и нажмите «Открыть».
10. Применить
11. При появлении запроса подтвердите, что хотите обновить прошивку, нажав OK
12. Подождите 2 минуты, пока завершится обновление прошивки

Через 2 минуты обновление прошивки будет завершено.Теперь важно выполнить сброс настроек роутера до заводских.

1. Перейдите на http://192.168.0.1 и используйте admin для имени пользователя и пароля, как и раньше
2. Слева нажмите Управление
3. Нажмите Управление настройками
4. Нажмите кнопку «Загрузить по умолчанию»

Теперь на вашем маршрутизаторе установлена ​​последняя доступная прошивка.

Huawei | Huawei HCNA ⋆ IPCisco

Во всех сетевых устройствах есть файловая система.В роутерах и коммутаторах Huawei также есть файловая система. Файловая система хранит многие важные файлы для системы, такие как файлы системы, файлы конфигурации, обновления программного обеспечения и т. Д.

Команды файловой системы

Практически все использовали командную строку окна (cmd). Некоторые команды используются с файловой системой на устройствах Huawei, и эти системные команды очень похожи на команды командной строки Windows.

Приведем несколько примеров команд этой файловой системы:

pwd: показывает текущий каталог
dir: показывает содержимое каталога
cd: используется для изменения текущего каталога
mkdir: используется для создания каталога
rmdir: используется для удаления каталога
подробнее: используется для просмотра содержимого файла
копия: используется для копирования файла
перемещение: используется для перемещения файла
удаление: используется для удаления файла
восстановление: используется для восстановления файла
переименование: используется дать файлу новое имя

Теперь поговорим о некоторых конкретных системных файлах.

Файлы конфигурации

— это файлы, которые включают все конфигурации устройства. В устройствах Huawei существует два типа файла конфигурации. Эти файлы конфигурации:

• Файл текущей конфигурации
• Файл сохраненной конфигурации

Current-Configuration — это последняя конфигурация устройства. Текущий файл конфигурации еще не во Flash. Он хранится в оперативной памяти.

Saved-Configuration — это последняя конфигурация, сохраненная на устройстве.Сохраненный файл конфигурации хранится во Flash и загружается отсюда при запуске системы.

Для просмотра этих двух файлов конфигурации мы будем использовать команды отображения.

  отображение текущей конфигурации 
 

  отображение сохраненной конфигурации 
 

на маршрутизаторе Asus RT-AX88U — Технический блог Neolisk

Вы когда-нибудь задумывались, как настроить локальный доступ к внешнему доступному ресурсу в вашей сети через то же доменное имя? Простой пример — хранилище NAS.В моем случае Synology DS918 +. После настройки SSL в домене * .synology.me я понял, что не могу получить доступ к NAS локально через то же доменное имя, только по IP. Но доступ по IP дает мне ошибки, связанные с SSL. Найти каждую часть решения было несложно. Есть всего несколько десятков движущихся частей. В моем случае слабым местом было знание Linux и использование командной строки, поскольку я вообще фанат графического интерфейса. Цель этой статьи — помочь соединить точки. Не стесняйтесь пропускать уже знакомые вам части.

Заявление об ограничении ответственности: действуйте на свой страх и риск. Я не несу ответственности, если вы сломаете маршрутизатор, локальный компьютер или любые другие устройства в вашей сети. Ожидается некоторый уровень системных / ИТ-знаний для понимания и правильного выполнения шагов. Ниже приводится содержание этой статьи. Если чтение чего-либо пугает вас, позвольте кому-нибудь другому выполнить настройку за вас.

Установите прошивку Merlin

Прошивка Merlin основана на стандартной прошивке Asus, улучшая стабильность и добавляя функции в этом порядке важности.Вы можете скачать последнюю версию для RX-AX88U здесь. Другие версии можно найти на сайте Мерлина.

Прошивка может быть прошита через:

  Администрирование -> Обновление прошивки -> Обновление прошивки вручную -> Загрузить
  

Я прилагаю скриншот области, потому что пользовательский интерфейс может немного сбивать с толку. Ниже приведен снимок экрана моего роутера, на котором уже установлена ​​прошивка Merlin. Когда это было на прошивке Asus, было не совсем очевидно, что ссылка «Загрузить» была правильным вариантом.

Включить JFFS на маршрутизаторе и перезагрузить

JFFS — одна из функций прошивки Merlin. Он позволяет хранить различные данные конфигурации, которые сохраняются после перезагрузки. Мы будем использовать его для хранения файла пользовательских хостов.

Чтобы включить JFFS, после входа в маршрутизатор перейдите сюда:

  Администрирование -> Система -> Постоянный раздел JFFS2
  

И измените вторую опцию Включить пользовательские скрипты и конфигурации JFFS с на Да .Прокрутите вниз и нажмите «Применить».

Включить SSH на маршрутизаторе

Предполагая, что вы все еще вошли в свой маршрутизатор, перейдите в следующий раздел конфигурации:

  Администрирование -> Система -> Сервис -> Включить SSH
  

Здесь установите Enable SSH на LAN Only и установите порт на значение, отличное от значения по умолчанию 22. Например, 22222. Не требуется изменять порт SSH по умолчанию, но рекомендуется предотвратить сканирование портов. атаки, даже если они сильно не похожи на домашнюю сетевую среду.Просто хорошая привычка.

Установите Putty на клиенте

Для этого вы можете использовать любой клиент Telnet, я буду использовать Putty. Подключитесь к router.asus.com — очень удобно, не нужно запоминать IP, порт 22222, если вы следуете этому руководству, или любой порт по вашему выбору. Введите имя пользователя / пароль по запросу.

Если вы впервые используете Putty или telnet, вы можете заметить, что положение курсора не меняется при вводе пароля. Для пользователей Windows поведение может показаться странным, но здесь все в порядке.Не пугайтесь, если вам кажется, что он не реагирует на нажатия клавиш. Кроме того, если вы сделаете ошибку, вы не сможете использовать backspace, и вам придется начинать заново.

Создать файл Hosts на маршрутизаторе

После подключения к маршрутизатору через telnet перейдите к / jffs / configs / . Вы можете ввести cd / jffs / configs / и нажать Enter. Затем создайте файл hosts.add . Есть несколько способов сделать это, я считаю простым использовать встроенный редактор nano .Введите nano hosts.add и нажмите Enter. Поместите желаемые записи хостов в следующем формате:

  (IP) (пробел или табуляция) (имя хоста)
  

Например:

  192.168.1.50 something.synology.me
  

В моем случае мне понадобилась всего одна запись. Следуйте подсказкам внизу, чтобы сохранить. Все функции основаны на управляющей клавише. Например, Ctrl + X для выхода, он запросит имя файла и сохранит.

Ссылки:

Перезагрузите маршрутизатор и проверьте

После отключения от сеанса telnet перезагрузите маршрутизатор и проверьте, чтобы убедиться, что новое настроенное имя DNS работает правильно при доступе из локальной сети.

Очистить кеш DNS на клиенте

Если это не сработает, вам, возможно, придется очистить кеш DNS, что выполняется с помощью следующей команды:

  ipconfig / flushdns
  

Его необходимо запустить в командной строке клиента (WIN + R -> cmd -> enter).

Ссылка: сброс подключения к Интернету (очистить DNS) @ Pearson

Отключить SSH

Этот шаг не является обязательным и зависит от того, нужен ли вам SSH для других целей. Если вам ни для чего не нужен SSH, рекомендуется отключить его, чтобы предотвратить несанкционированный доступ к вашему маршрутизатору.