Бесплатный урок

Запустить узкий локальный сервер

Запустить узкий локальный сервер — Создать локальный AI-чат. Работать только на loopback; Сохранить server.mjs; Проверить сервис и отсутствующие пути. Практическое задание: Доказательства лабораторной работы.

Демо-версия. Материалы проходят редакторскую проверку.

Что рассмотрим

  • Работать только на loopback
  • Сохранить server.mjs
  • Проверить сервис и отсутствующие пути

Работать только на loopback

Запустите на 127.0.0.1:3000. Так локальная граница явна; это не аутентификация от всех процессов этого компьютера.

Браузер показывает сообщения, сервер приложения проверяет запросы, Ollama генерирует текст. Разделите обязанности, чтобы браузер не выбирал произвольные endpoint моделей и не читал серверные файлы. Во время разработки используйте синтетические вопросы мастерской. Ответ модели — сгенерированный текст, не проверенный совет. Локальная граница сокращает внешнюю передачу, но не защищает от всех локальных пользователей, браузерных расширений или настроенных интеграций.

Сохранить server.mjs

Сервер открывает лишь два точных статических пути и health. До клиентского урока создайте пустой app.js; отсутствующий файл должен давать ошибку.

Статический allowlist намеренно отклоняет query-варианты и неизвестные пути. Это сужает упражнение и не позволяет обходить файловую систему через URL. Добавляя URL-парсер или папку ресурсов, напишите проверки маршрутов, не удаляйте allowlist ради одного отсутствующего файла.

Создайте названные файлы в одной учебной папке и запускайте Node оттуда. В примере модель и адрес бэкенда закреплены на сервере. До потока проверьте ввод и статус upstream; после начала ошибка передаётся записью потока или видимым состоянием прерывания. Различайте лимит байтов, сообщений и контекста модели: они контролируют разные ресурсы. Проверяйте каждый отдельно, сохраняя конкретный запрос для воспроизведения отказа.

import http from 'node:http';
import {readFile} from 'node:fs/promises';
const files={'/':['index.html','text/html; charset=utf-8'],'/app.js':['app.js','text/javascript; charset=utf-8']};
http.createServer(async(req,res)=>{try{
 if(req.method==='GET'&&req.url==='/health'){res.writeHead(200,{'Content-Type':'text/plain'});return res.end('ok');}
 // Insert the POST /api/chat branch here in the next lesson.
 const item=req.method==='GET'?files[req.url]:null;if(!item){res.writeHead(404);return res.end('Not found');}
 const data=await readFile(item[0]);res.writeHead(200,{'Content-Type':item[1],'X-Content-Type-Options':'nosniff'});res.end(data);
}catch{if(!res.headersSent)res.writeHead(500);res.end('Local server error');}}).listen(3000,'127.0.0.1');
// Terminal: node server.mjs

Проверить сервис и отсутствующие пути

Откройте health и главную, затем несуществующий файл. Health подтверждает сервер приложения, но не модель. Ollama проверьте отдельно.

Проверьте успешный ответ, остановленный сервис, прерывание и слишком большой ввод. Частичный текст обозначайте частичным, не завершённым. История живёт только в памяти интерфейса и очищается; это не стирает журналы ОС или внешние копии. До публичного развёртывания добавьте аутентификацию, авторизацию, TLS, квоты, политику хранения и мониторинг. Локальное демо не доказывает наличие этих средств, даже если выглядит как готовый сервис.

curl -i http://127.0.0.1:3000/health
curl -i http://127.0.0.1:3000/missing
curl -sS http://127.0.0.1:11434/api/tags

Практическое задание

Доказательства лабораторной работы

Перейти к обучению

Программа курса

  1. Определить границы и создать интерфейс
  2. Запустить узкий локальный сервер
  3. Проксировать ограниченный поток модели
  4. Разбирать поток в браузере
  5. Ограничить сессию, ввод и ресурсы
  6. Проверить приложение и развёртывание