Skip to content
Config & environment variables

Config & environment variables

View raw
On this page

ตัวแปรทั้งหมดถูกตรวจใน src/lib/server/env.ts (zod) ค่าที่ไม่ถูกต้องถูกแทนด้วยค่าเริ่มต้นและ log เฉพาะชื่อ วิธีจัดการ secret ดู operations/env-secrets.md

ตัวแปรของแอป#

ชื่อ ชนิด ค่าที่อนุญาต ค่าเริ่มต้นในโค้ด ค่าใน wrangler.jsonc ใช้ทำอะไร
OPENAI_API_KEY secret ^[\w-]{20,400}$ ไม่มี → offline planner ตั้งด้วย wrangler secret put key ของผู้ดูแลสำหรับ AI planner
OPENAI_MODEL var ^[\w.:-]{1,80}$ gpt-6.1-sol (DEFAULT_MODEL) gpt-6.1-sol โมเดลของ Responses API
OPENAI_MAX_OUTPUT_TOKENS var จำนวนเต็ม 512–16000 6000 6000 cost guard ต่อคำขอ (เพดานแข็ง 16000)
OPENAI_TIMEOUT_MS var 5000–120000 60000 75000 timeout ของการเรียก OpenAI หนึ่งครั้ง (route เผื่ออีก 5 วินาที)
PLAN_LIMIT_PER_MIN var 1–6000 20 — limit ของ general limiter แบบ in-memory (ใช้นอก Workers หรือเมื่อ binding ล้ม)
PLAN_AI_LIMIT_PER_MIN var 1–600 5 — limit ของ AI limiter แบบ in-memory
HF_TOKEN secret ^hf_[\w]{20,200}$ ไม่มี → ข้าม HF ตั้งด้วย wrangler secret put HF_TOKEN (stdin) token Hugging Face (Pro) สำหรับ planner และโหมด "เก่งขึ้น" ใน User Chat
HF_MODEL var ^[\w./:-]{1,120}$ deepseek-ai/DeepSeek-V3 deepseek-ai/DeepSeek-V3 โมเดลหลักของ planner และโหมด strong
HF_FAST_MODEL var เหมือนกัน meta-llama/Llama-3.1-8B-Instruct เหมือนกัน โมเดลเร็ว (สำรอง)
HF_BASE_URL var URL https https://router.huggingface.co/v1 — endpoint แบบ OpenAI-compatible ของ HF router
HF_TIMEOUT_MS var 5000–120000 60000 — timeout ของการเรียก HF หนึ่งครั้ง
HF_MAX_TOKENS var 128–8000 1500 — เพดาน output ของแชต
HF_PLAN_MAX_TOKENS var 512–16000 6000 — เพดาน output ของ planner
OPENAI_FALLBACK var true / false false false ให้ planner ถอยไปใช้ OpenAI key ของเซิร์ฟเวอร์เมื่อ HF ล้มหรือไม่ (ปิดไว้เพื่อสงวนเครดิตให้ Orchestrator)

ตัวแปรของแชต (src/lib/chat/config.ts)#

ค่าโควตาแบบรายวันรีเซ็ตตอนเที่ยงคืนเวลาไทย (Asia/Bangkok, UTC+7) นับต่อ cookie (nvx_chat_uid, ลงลายเซ็น HMAC) และมีเพดานต่อ IP = ค่าต่อผู้ใช้ × FREE_IP_MULTIPLIER

ชื่อ ชนิด ค่าเริ่มต้นในโค้ด ค่าใน wrangler.jsonc ใช้ทำอะไร
CHAT_COOKIE_SECRET secret ไม่มี → แชตปิด wrangler secret put key HMAC ของ cookie ระบุผู้ใช้ (≥32 ตัวอักษร)
CHAT_ENABLED var true true ปิดทั้ง User Chat และ Dev Chat ได้ทันที
CHAT_MAX_INPUT_CHARS var 2000 2000 ความยาวข้อความสูงสุด
CHAT_TURN_TIMEOUT_MS var 180000 180000 เวลาสูงสุดต่อหนึ่ง turn
CHAT_BURST_PER_MIN var 4 — limit in-memory สำรองเมื่อไม่มี NVX_CHAT_LIMITER
FREE_DAILY_MESSAGES var 20 20 User Chat: ข้อความฟรีต่อวันต่อ cookie
FREE_DAILY_IMAGES var 5 5 User Chat: ภาพฟรีต่อวันต่อ cookie (ไม่นับรวมกับข้อความ)
FREE_IP_MULTIPLIER var 3 3 ตัวคูณเพดานต่อ IP
MAX_ATTACHMENT_BYTES var 10485760 10485760 ขนาดไฟล์แนบสูงสุด (10 MB) บังคับใน /api/chat/attachments
CHAT_USER_GLOBAL_PER_DAY var 3000 3000 User Chat: ข้อความรวมทั้งเว็บต่อวัน (คุม neurons/เครดิต HF)
CHAT_USER_GLOBAL_IMAGES_PER_DAY var 500 500 User Chat: ภาพ FLUX รวมทั้งเว็บต่อวัน
WAI_MODEL var @cf/google/gemma-4-26b-a4b-it เหมือนกัน โหมดทั่วไป (Workers AI)
WAI_THAI_MODEL var @cf/aisingapore/gemma-sea-lion-v4-27b-it เหมือนกัน โหมดภาษาไทย (SEA-LION)
WAI_CODE_MODEL var @cf/qwen/qwen2.5-coder-32b-instruct เหมือนกัน โหมดโค้ด
WAI_IMAGE_MODEL var @cf/black-forest-labs/flux-1-schnell เหมือนกัน สร้างภาพ (4 steps)
WAI_MAX_TOKENS var 1500 1500 เพดาน output ของ Workers AI
CHAT_MODEL var gpt-6.1-sol gpt-6.1-sol Dev Chat: โมเดลของ Orchestrator agent
CHAT_AGENT_ID var "" "" ว่าง = ใช้ config inline จาก agents/orchestrator/agent.json
CHAT_REASONING_EFFORT var low low reasoning effort ของ agent
CHAT_ENVIRONMENT var openai_hosted openai_hosted sandbox ของ Dev Chat (none / openai_hosted)
CHAT_CONTAINER_SIZE var small small ขนาด sandbox ที่ OpenAI host
CHAT_MAX_OUTPUT_TOKENS var 2000 2000 เพดาน output ต่อ turn ของ agent (ใส่ใน instructions/ฟังก์ชันภาพ)
CHAT_AGENT_TURNS_PER_DAY var 5 5 Dev Chat: turn ต่อวันต่อ cookie
CHAT_GLOBAL_TURNS_PER_DAY var 30 30 Dev Chat: turn รวมทั้งเว็บต่อวัน (ปกป้องเครดิต OpenAI ~$30)
CHAT_AGENT_IMAGES_PER_DAY var 2 2 Dev Chat: ภาพ OpenAI ต่อวันต่อ cookie
CHAT_GLOBAL_IMAGES_PER_DAY var 20 20 Dev Chat: ภาพ OpenAI รวมทั้งเว็บต่อวัน
CHAT_IMAGE_MODEL var gpt-image-2.5-sunburst เหมือนกัน โมเดลภาพของ agent
CHAT_IMAGE_QUALITY var low low คุณภาพภาพของ agent
CHAT_DAILY_BUDGET_USD var 1 1 งบรวมต่อวันของ Dev Chat (ประมาณจาก usage)
FACTORY_ENABLED var true true เปิด/ปิด Sandbox Factory
FACTORY_SESSIONS_PER_HOUR var 10 10 session ใหม่ต่อ IP ต่อชั่วโมง (กันสแปม ใช้ key ผู้ใช้เอง)
FACTORY_TURNS_PER_HOUR var 60 60 turn ต่อ IP ต่อชั่วโมง
FACTORY_BURST_PER_MIN var 10 — limit in-memory สำรองเมื่อไม่มี NVX_FACTORY_LIMITER

| NEXT_PUBLIC_REPO_URL | build-time (public) | URL https:// ของ repo เช่น https://github.com/<owner>/nvx-stack-builder | ไม่ตั้ง | — | เปิดปุ่ม "Edit on GitHub" ในหน้า /docs และเปลี่ยนลิงก์ไปไฟล์โค้ดในเอกสารเป็นลิงก์ GitHub (src/lib/docs.ts, scripts/build-docs.mjs) ค่าที่ไม่ใช่ https ถูกเมิน ถ้าไม่ตั้ง ปุ่มจะซ่อน | | NEXT_PUBLIC_SITE_URL | build-time (public) | URL เต็ม | https://devstack.bid | — | metadataBase ใน src/app/layout.tsx ใช้สร้าง URL เต็มของ og:image / twitter:image ถูกฝังตอน build (ไม่ใช่ secret) ถ้า deploy ไปโดเมนอื่นให้ตั้งก่อน npm run cf:build |

ค่าว่าง ("") ถือว่าไม่ได้ตั้ง

Cloudflare bindings (ใน wrangler.jsonc)#

Binding ชนิด ค่า ใช้ทำอะไร
NVX_PLAN_LIMITER ratelimit (namespace 4712) 20 / 60 วินาที ทุก POST /api/plan
NVX_PLAN_AI_LIMITER ratelimit (namespace 4711) 5 / 60 วินาที POST ที่ใช้ key ของเซิร์ฟเวอร์
ASSETS assets (.open-next/assets) — เสิร์ฟไฟล์ static/prerendered
WORKER_SELF_REFERENCE service (nvx-stack-builder) — OpenNext ใช้สำหรับ cache revalidation; ต้องตรงกับ name
DB D1 (nvx-db, id 3ee9bbab-06b5-49da-b175-5f7162ad5086, migrations_dir: migrations) — ประวัติแชตของทั้งสองแชตและ Factory (คอลัมน์ channel), ตัวนับโควตา usage_counters ดู d1-schema.md
AI Workers AI — โมเดลของ User Chat (WAI_*) ใช้ free allowance 10,000 neurons/วัน แล้วคิด $0.011 ต่อ 1,000 neurons ตอน wrangler dev/preview binding นี้รันแบบ remote เสมอ (ใช้โควตาจริงของบัญชี)
NVX_CHAT_LIMITER ratelimit (namespace 4713) 4 / 60 วินาที burst ของ /api/chat/turn และ /api/chat/dev/turn
NVX_FACTORY_LIMITER ratelimit (namespace 4714) 10 / 60 วินาที burst ของ /api/factory/*

ASSETS_BUCKET (R2 bucket nvx-assets) ยังไม่ได้เพิ่ม เพราะบัญชียังไม่เปิด R2 ขั้นตอนอยู่ที่ d1-database.md อย่าใส่ binding ก่อนมี bucket จริง เพราะ deploy จะล้ม

การตั้งค่าอื่นใน wrangler.jsonc#

name: nvx-stack-builder, compatibility_date: 2026-10-06, compatibility_flags: [nodejs_compat, global_fetch_strictly_public], workers_dev: true, preview_urls: false, ไม่มี routes, observability.enabled: true (head_sampling_rate: 1), upload_source_maps: true

ตัวแปรสำหรับเครื่องมือ (ไม่ได้อ่านในแอป)#

ชื่อ ใช้กับ หมายเหตุ
CLOUDFLARE_API_TOKEN wrangler (deploy, secret, rollback) token เท่านั้น ห้ามพิมพ์/commit สิทธิ์ขั้นต่ำ Workers Scripts: Edit + Account Settings: Read; คำสั่ง wrangler d1 ต้องมี D1: Edit และ R2 ต้องมี Workers R2 Storage: Edit
CLOUDFLARE_ACCOUNT_ID wrangler บัญชี production 2d92bd5b25768fa9093d6adc0a8887fc (devstack.bid, workers.dev examplessdk); บัญชีเดิม f70d35188a3c56b9781538c73a86e04e (v0.3.0)
NODE_ENV Next.js development เปิด CSP แบบ dev (unsafe-eval, ws:) และไม่ส่ง HSTS

ไฟล์ตัวอย่าง#

  • .env.example → คัดลอกเป็น .env.local สำหรับ next dev/next start (มี OPENAI_API_KEY, OPENAI_MODEL)
  • .dev.vars.example → คัดลอกเป็น .dev.vars สำหรับ npm run preview (มี OPENAI_API_KEY และตัวเลือกที่คอมเมนต์ไว้)

localStorage ฝั่ง client (ไม่ใช่ env แต่เป็น config ของผู้ใช้)#

คีย์ ค่า ใช้ทำอะไร
nvx-theme dark | light ธีม (ไม่มีค่า = ดำ)
nvx-lang th | en ภาษา (ไม่มีค่า = ตาม navigator.language)
nvx-builder-state share token สถานะ builder ล่าสุด

เมื่อเพิ่มตัวแปรใหม่#

เพิ่มใน schema ของ env.ts (พร้อม .catch() ค่าเริ่มต้นที่ปลอดภัย), .env.example/.dev.vars.example และ/หรือ vars ใน wrangler, ตารางในหน้านี้, platform-manifest.json, test ใน tests/production.test.ts — npm run docs:check จะล้มถ้าลืมเพิ่มในหน้านี้

Source: docs/reference/config-env.md · /docs/reference/config-env.md