Open WebUI நிறுவல் மற்றும் OmniProxy உள்ளமைவு

Open WebUI என்பது உங்கள் சொந்த கணினி அல்லது சர்வரில் நிறுவக்கூடிய ஒரு சுய-ஹோஸ்ட் செய்யப்பட்ட சாட் இடைமுகமாகும், மேலும் இது முற்றிலும் ஆஃப்லைனிலும் இயங்க முடியும். இது எந்த ஒரு மாடல் வழங்குநருடனும் பிணைக்கப்படவில்லை: இது மாடல்களை உள்ளூர் அளவில் இயக்கும் Ollama போன்ற கருவிகளுடனும், அதேபோல் OpenAI-இணக்கமான எண்ட்-பாயிண்டுகளுடனும்—அதே கோரிக்கை வடிவத்தைப் பயன்படுத்தி மாடல் சேவைகளை வழங்கும் முகவரிகள்—இணைக்க முடியும். இது ஒரே விண்டோவில் உள்ளூர் மற்றும் கிளவுட் மாடல்களுக்கு இடையே மாற உங்களை அனுமதிக்கிறது.

இது குழுக்கள் மற்றும் நிறுவனங்களின் நீண்டகால பயன்பாட்டிற்கு ஏற்றது. வேகமான புதுப்பிப்புகளைப் பெறும் திறன்கள் முதலில் Computer-ல் தோன்றும், இது புதிய அம்சங்களை முயற்சி செய்ய Open WebUI பயன்படுத்தும் தயாரிப்பாகும்.

தொடங்குவதற்கு முன்

Open WebUI macOS, Linux மற்றும் Windows-ல் கிடைக்கிறது. நீங்கள் Docker, Python அல்லது Kubernetes-ஐப் பயன்படுத்தி அதை நிறுவலாம். Docker அப்ளிகேஷனையும் அதன் ரன்டைம் சூழலையும் ஒப்பீட்டளவில் தனிமைப்படுத்தப்பட்ட கன்டெய்னரில் பேக் செய்கிறது மற்றும் இது பரிந்துரைக்கப்பட்ட முறையாகும். Docker கிடைக்கவில்லை என்றால், கீழே உள்ள சோதிக்கப்பட்ட Python கட்டளையையும் பயன்படுத்தலாம். Kubernetes என்பது கன்டெய்னர்களை வரிசைப்படுத்தவும் நிர்வகிக்கவும் பயன்படும் ஒரு அமைப்பாகும்; தொடர்புடைய படிகளுக்கு இந்த வழிகாட்டியின் முடிவில் இணைக்கப்பட்டுள்ள Quick Start-ஐப் பார்க்கவும்.

அதிகாரப்பூர்வமாக பரிந்துரைக்கப்படுகிறது

Docker

• ஒரு docker run கட்டளை
• பிரவுசரில் 3000-ஐத் திறக்கவும்
• தரவு வால்யூமில் சேமிக்கப்படுகிறது

சாட் செய்ய மட்டும் விரும்புகிறீர்களா

slim இமேஜ்

• சிறிய பதிவிறக்க அளவு
• டேக்கை :slim என்று மாற்றவும்
• சாட் செயல்பாடு தொடர்ந்து கிடைக்கும்

இங்கே உள்ளடக்கப்படவில்லை

பிற இரண்டு விருப்பங்கள்

• மேனுவல் Python நிறுவல்
• Kubernetes வரிசைப்படுத்தல்
• அதிகாரப்பூர்வ Quick Start-ஐப் பார்க்கவும்

தொடங்குவதற்கு முன், பின்வருவனவற்றைத் தயார் செய்யவும்:

• Docker நிறுவப்பட்டு இயங்குகிறது.
• உங்களால் மட்டுமே பயன்படுத்தப்படும் ஒரு ரகசிய சரம். ஒன்றை உருவாக்க openssl rand -hex 32-ஐ இயக்கவும், பின்னர் அதை WEBUI_SECRET_KEY ஆக உள்ளிடவும். இந்த மதிப்பை நிரந்தரமாகச் சேமிக்கவும். கன்டெய்னரை மீண்டும் உருவாக்கும்போது இதை மாற்றினால், ஏற்கனவே உள்நுழைந்த பயனர்கள் வெளியேற்றப்படுவார்கள்.
• இயங்கும் OmniProxy நிகழ்வு மற்றும் அதன் தற்போதைய மாடல் பட்டியலிலிருந்து ஒரு மாடல் ஐடி. மாடல் ஐடி என்பது ஒரு குறிப்பிட்ட மாடலைத் தேர்ந்தெடுக்கப் பயன்படும் முழுப் பெயராகும்.

முதல் முறையாக நிறுவுதல் மற்றும் தொடங்குதல்

ஒரு டெர்மினலைத் திறந்து Quick Start-லிருந்து கட்டளையை இயக்கவும். முதலில் your-secret-key-ஐ நீங்கள் உருவாக்கிய ரகசியத்துடன் மாற்றவும்:

docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data -e WEBUI_SECRET_KEY=your-secret-key --name open-webui --restart always ghcr.io/open-webui/open-webui:main

இந்த கட்டளையின் பின்வரும் பகுதிகள் வெவ்வேறு நோக்கங்களுக்காகப் பயன்படுகின்றன:

• -p 3000:8080: இந்த கணினியில் போர்ட் 3000 வழியாக இடைமுகத்தைத் திறக்க உங்களை அனுமதிக்கிறது. போர்ட் 3000 ஏற்கனவே பயன்பாட்டில் இருந்தால், இடதுபுறத்தில் உள்ள எண்ணை மாற்றவும்.
• -v open-webui:/app/backend/data: சாட்கள், பயனர்கள் மற்றும் அமைப்புகளை ஒரு டேட்டா வால்யூமில் சேமிக்கிறது. டேட்டா வால்யூம் என்பது கன்டெய்னருக்கு வெளியே உள்ள ஒரு இடமாகும், அங்கு தரவு நீண்ட காலத்திற்குத் தக்கவைக்கப்படுகிறது, எனவே கன்டெய்னர் புதுப்பிக்கப்பட்ட பிறகும் அதன் உள்ளடக்கங்கள் இருக்கும். இந்த விருப்பத்தை நீக்க வேண்டாம்.
• --add-host=host.docker.internal:host-gateway: இந்த கணினியில் இயங்கும் பிற சேவைகளை கன்டெய்னர் அணுக அனுமதிக்கிறது.
• --restart always: கணினி ரீபூட் ஆன பிறகு கன்டெய்னரை மீண்டும் தொடங்குகிறது.

கட்டளை முடிந்ததும், பிரவுசரில் http://localhost:3000-ஐத் திறந்து, முதல் கணக்கை உருவாக்க திரையில் உள்ள வழிமுறைகளைப் பின்பற்றவும்.

நீங்கள் API வழியாக மட்டுமே சாட் செய்ய வேண்டும் என்றால், இமேஜ் டேக்கை :main-லிருந்து :slim-க்கு மாற்றலாம். slim என்பது சிறிய இமேஜ் ஆகும், இது கன்டெய்னருக்குள் உள்ளூர் ஸ்பீச் மற்றும் எம்பெடிங் மாடல்களை உள்ளடக்குவதில்லை, ஆனால் சாட் இடைமுகம் தொடர்ந்து கிடைக்கும். அந்த உள்ளூர் திறன்கள் தேவைப்பட்டால் :main-ஐப் பயன்படுத்துவதைத் தொடரவும்.

மேனுவல் புதுப்பிப்புகளுக்கு, முதலில் docker rm -f open-webui-ஐ இயக்கி, பின்னர் docker pull ghcr.io/open-webui/open-webui:main-ஐ இயக்கி, அதே docker run கட்டளையுடன் அதை மறுதொடக்கம் செய்யவும். டேட்டா வால்யூம் மற்றும் WEBUI_SECRET_KEY இரண்டையும் மாற்றாமல் வைத்திருக்கவும்.

Docker கிடைக்கவில்லை என்றால்

Quick Start ஒரு Python நிறுவல் முறையையும் வழங்குகிறது. 2026-10-09 அன்று, macOS-ல் Open WebUI v0.11.4-ஐ நிறுவவும் ஒரு உரையாடலை முடிக்கவும் பின்வரும் கட்டளை பயன்படுத்தப்பட்டது. அந்த நேரத்தில் அந்த கணினியில் Docker Desktop நிறுவப்படவில்லை.

DATA_DIR=~/.open-webui uvx --python 3.11 open-webui@latest serve

தொடங்கிய பிறகு, பிரவுசரில் http://localhost:8080-ஐத் திறக்கவும். இது Python நிறுவல் பயன்படுத்தும் போர்ட், Docker-ன் போர்ட் 3000 அல்ல.

முதல் தொடக்கத்தின் போது ஒரு எம்பெடிங் மாடல் பதிவிறக்கம் செய்யப்படுகிறது, இதற்கு பல நிமிடங்கள் ஆகலாம். எம்பெடிங் மாடல் உரையைத் தேடுவதற்கும் பொருத்துவதற்கும் எளிதான தரவாக மாற்றுகிறது. தொடர்வதற்கு முன் உள்நுழைவுப் பக்கம் தோன்றும் வரை காத்திருக்கவும். முதல் பதிவுசெய்யப்பட்ட கணக்கு நிர்வாகியாகிறது. இடைமுக மொழி சிஸ்டம் மொழியைப் பின்பற்றுகிறது; இந்த சோதனையின் போது எளிமைப்படுத்தப்பட்ட சீன மொழி காட்டப்பட்டது.

DATA_DIR நீண்ட காலத்திற்குத் தக்கவைக்கப்படும் மற்றும் Open WebUI தரவைச் சேமிக்கப் பயன்படுத்தப்படும் டைரக்டரியைச் சுட்டிக்காட்ட வேண்டும். அது அமைக்கப்படவில்லை என்றால், தரவு தற்காலிக டைரக்டரியில் சேமிக்கப்பட்டு ஷட்-டவுனுக்குப் பிறகு இழக்கப்படலாம். WEBUI_SECRET_KEY அமைக்கப்படவில்லை என்றால், நிரல் தற்போதைய டைரக்டரியில் .webui_secret_key-ஐ எழுதுகிறது. நீங்கள் தக்கவைக்க விரும்பும் டைரக்டரியிலிருந்து அதைத் தொடங்கவும் அல்லது இந்த வேரியபிளை நீங்களே அமைக்கவும்.

OmniProxy-லிருந்து இணைப்பு விவரங்களைப் பெறுதல்

உங்கள் சொந்த OmniProxy நிகழ்விலிருந்து பின்வரும் மூன்று உருப்படிகளை நகலெடுக்கவும்:

URL:      https://your-omniproxy-origin.example/v1
API Key:  <YOUR_OMNIPROXY_API_KEY>
Model ID: Copy from the current OmniProxy model list

URL என்பது Open WebUI எண்ட்-பாயிண்டுடன் இணைக்கப் பயன்படுத்தும் முகவரியாகும், இது /v1-ல் முடிவடைய வேண்டும். அதற்குப் பிறகு /chat/completions-ஐச் சேர்க்க வேண்டாம்; Open WebUI அந்தப் பகுதியைத் தானாகவே சேர்க்கிறது.

OmniProxy-ன் தற்போதைய பட்டியலிலிருந்து முழு மாடல் ஐடியையும் நகலெடுக்கவும். ஐடி ஒரு ஆதார முன்னொட்டு (source prefix) மற்றும் ஸ்லாஷைக் கொண்டிருந்தால், அவற்றையும் பாதுகாக்கவும். பின்வரும் இரண்டு குறுகிய பெயர்கள் 2026-10-09 நிலவரப்படி வழங்குநர் ஆவணங்களிலிருந்து பெறப்பட்ட குறிப்புகள் மட்டுமே. அவை தற்போதைய பட்டியலில் இல்லை என்றால் அவற்றைப் பயன்படுத்த வேண்டாம்:

• Claude Sonnet 5.5-க்கான Claude API ID: claude-sonnet-5-5
• Gemini 3.8 Flash-க்கான API பெயர்: gemini-3.8-flash

Open WebUI-ல் வழங்குநர் கீயை உள்ளிட வேண்டாம். Gateway கீகளைச் சரிபார்க்கவில்லை என்றால், மற்றொரு கீயை உருவாக்குவதற்குப் பதிலாக API கீயைக் காலியாக விடவும்.

பிரவுசர்

உள்ளூர் போர்ட் 3000

• சாட் பக்கத்தைத் திறக்கவும்
• முதலில் பதிவை முடிக்கவும்
• பிறகு அமைப்புகளைத் திறக்கவும்

கன்டெய்னருக்குள்

Open WebUI

• localhost-ஐப் பயன்படுத்த வேண்டாம்
• அதற்குப் பதிலாக ஹோஸ்ட் மெஷின் பெயரைப் பயன்படுத்தவும்
• URL /v1-ல் முடிவடைகிறது

ஒரே கணினி

OmniProxy

• கீயை Gateway-ல் வைத்துக்கொள்ளவும்
• Gateway-ன் மாடல் பட்டியலைப் பயன்படுத்தவும்
• பிறகு கோரிக்கை பதிவுகளை மதிப்பாய்வு செய்யவும்

மாடல் சேவை ஹோஸ்டில் இயங்கும்போது மற்றும் Open WebUI Docker கன்டெய்னரில் இயங்கும்போது, URL-ல் உள்ள localhost-ஐ host.docker.internal-ஆல் மாற்றவும். ஹோஸ்ட் என்பது Docker-ஐ நேரடியாக இயக்கும் கணினியாகும். OmniProxy இந்த கணினியில் மட்டுமே கேட்டால், URL-ஐ http://host.docker.internal:port/v1 என்று எழுதலாம், port-ஐ OmniProxy உண்மையில் பயன்படுத்தும் போர்ட்டால் மாற்றவும்.

Open WebUI முந்தைய பிரிவில் உள்ள Python கட்டளை வழியாக உள்ளூர் அளவில் இயங்கினால் மற்றும் OmniProxy-ம் உள்ளூர் அளவில் இயங்கினால், முகவரியில் 127.0.0.1 அல்லது localhost-ஐப் பயன்படுத்தவும். இந்த வழக்கில் host.docker.internal-ஐப் பயன்படுத்த வேண்டாம்.

உள்ளமைவை உள்ளிடுதல்

2026-10-09 அன்று சோதிக்கப்பட்ட v0.11.4-ன் எளிமைப்படுத்தப்பட்ட சீன இடைமுகத்தில், பெயர்கள் ஆங்கில வழிமுறைகளில் உள்ள Settings > Admin > Connections என்பதிலிருந்து வேறுபட்டன. சோதிக்கப்பட்ட இடைமுகத்தில் காட்டப்பட்டுள்ள விருப்பங்களைப் பின்பற்றவும், கீழே மொழிபெயர்க்கப்பட்டுள்ளது:

1. இடது பக்கப் பட்டியை விரிக்கவும்.
2. கீழே உள்ள பயனர் மெனுவைக் கிளிக் செய்யவும்.
3. Settings-ஐக் கிளிக் செய்யவும்.
4. கீழே உள்ள நிர்வாகி பிரிவில், External Connections-ஐக் கிளிக் செய்யவும்.
5. OpenAI API-ஐத் திறக்கவும்.
6. Manage OpenAI API Connections-க்கு வலதுபுறம் உள்ள +-ஐக் கிளிக் செய்யவும்.
7. Edit Connection உரையாடல் பெட்டியில், /v1-ல் முடிவடையும் URL-ஐ உள்ளிடவும். API வகையை Chat Completions என்று வைத்திருக்கவும்.
8. Authentication Method-ஐ Key (Bearer) என்று வைத்திருக்கவும். Bearer அங்கீகாரம் அடையாளச் சரிபார்ப்பிற்காக கோரிக்கையில் API கீயை வைக்கிறது. OmniProxy உங்களுக்கு ஒரு கீயைக் கொடுத்திருந்தால், அதை API Key-ன் கீழ் உள்ளிடவும். Gateway கீகளைச் சரிபார்க்கவில்லை என்றால், இந்த புலத்தைக் காலியாக விடவும். 2026-10-09 அன்று, புலத்தைக் காலியாக விட்டாலும் சரிபார்ப்பு மற்றும் ஒரு உரையாடல் ஆகிய இரண்டும் வெற்றிபெற்றன.
9. URL-க்கு அருகில் உள்ள Verify Connection-ஐக் கிளிக் செய்யவும். OmniProxy /models-ஐ வழங்கினால், மாடல் பட்டியல் இங்கே பெறப்படும்.
10. Advanced-ஐத் திறக்கவும். Model ID காலியாக விடப்பட்டால், அந்த முகவரியில் /models-ஆல் திரும்பப் பெறப்படும் அனைத்து மாடல்களும் பயன்படுத்தப்படும். சரிபார்ப்பு தோல்வியடைந்தால் மட்டுமே, பட்டியலிலிருந்து முழுமையான ஐடியை Add Model ID-ன் கீழ் உள்ளிட்டு, பின்னர் Add-ஐக் கிளிக் செய்யவும். ஒவ்வொரு ஐடியையும் ஒருமுறை மட்டுமே சேர்க்கவும்; முன்னால் மற்றும் பின்னால் உள்ள இடைவெளிகள் நீக்கப்படும்.
11. இந்த விண்டோவில் Save-ஐக் கிளிக் செய்யவும், பின்னர் External Connections பக்கத்தின் கீழ்-வலது மூலையில் உள்ள Save-ஐக் கிளிக் செய்யவும்.

உள்ளமைவைச் சேமிப்பது மட்டும் சரிபார்ப்பிற்குப் பதிலாகாது. Verify Connection மற்ற சேவையின் /models எண்ட்-பாயிண்டைக் கோருகிறது, இது கிடைக்கக்கூடிய மாடல்களைப் பட்டியலிடுகிறது. சில சேவைகள் இந்த எண்ட்-பாயிண்டை வழங்குவதில்லை, எனவே சாட் வேலை செய்தாலும் சரிபார்ப்பு பிழையைப் புகாரளிக்கலாம். அந்த நிலையில், மாடல் ஐடியை மேனுவலாகச் சேர்க்கவும்.

உண்மையான பணியைச் சரிபார்க்கவும்

சாட் பக்கத்திற்குத் திரும்பி, உள்ளீட்டுப் பெட்டிக்கு அருகில் உள்ள மாடல் மெனுவைத் திறந்து, OmniProxy பட்டியலிலிருந்து முழுமையான ஐடியைத் தேர்ந்தெடுக்கவும். மிகச் சிறிய செய்தியை அனுப்பவும், உதாரணமாக ஒரே ஒரு வார்த்தையில் பதிலளிக்குமாறு கேட்கவும். சாட் பெட்டியில் ஒரு பதில் உண்மையில் தோன்ற வேண்டும்.

2026-10-09 அன்று, இந்த உரையாடல் v0.11.4-ன் Python நிறுவலைப் பயன்படுத்தி முடிக்கப்பட்டது. Docker பரிந்துரைக்கப்பட்ட முறையாகவே உள்ளது, ஆனால் சோதனை Docker-ல் மீண்டும் செய்யப்படவில்லை.

அடுத்து, OmniProxy-ன் கோரிக்கை பதிவுகளைத் திறந்து, இந்த கோரிக்கைக்கு ஆதாரம் மற்றும் மாடல் ஐடியை உறுதிப்படுத்தவும். வெற்றிகரமான சேமிப்பைப் பார்ப்பது அல்லது மெனுவில் மாடலை மட்டும் பார்ப்பது முடிந்தது என்று அர்த்தமல்ல.

இடைமுகம்

மாடலைத் தேர்ந்தெடுக்க முடியும்

• இணைப்புகள் சேமிக்கப்பட்டுள்ளன
• மாடல் பட்டியலில் தோன்றுகிறது
• சிறிய கேள்வியை அனுப்பவும்

பதில்

சாட் பெட்டி ஒரு பதிலைக் காட்டுகிறது

• இது காலியான செய்தி அல்ல
• இது இணைப்புப் பிழை அல்ல
• மற்றொரு மாடலுடன் மீண்டும் முயற்சிக்கவும்

பதிவுகள்

Gateway-ல் தெரியும்

• ஆதாரம் இந்த இணைப்பு
• மாடல் ஐடி பொருந்துகிறது
• பக்கத்தில் கீ எதுவும் உள்ளிடப்படவில்லை

பொதுவான பிழைகள்

• கன்டெய்னருக்குள் localhost அல்லது 127.0.0.1 பயன்படுத்தப்பட்டது: இந்த முகவரிகள் ஹோஸ்டை அல்ல, கன்டெய்னரையே சுட்டிக்காட்டுகின்றன. முகவரியை host.docker.internal என்று மாற்றி, தொடக்கக் கட்டளையில் --add-host=host.docker.internal:host-gateway உள்ளதா என்பதை உறுதிப்படுத்தவும். Open WebUI கன்டெய்னரில் இயங்காதபோது இதற்கு நேர்மாறானது பொருந்தும்: அதற்குப் பதிலாக உள்ளூர் முகவரியைப் பயன்படுத்தவும்.
• பிரவுசரால் பக்கத்தைத் திறக்க முடியவில்லை: Docker-க்கு, போர்ட் 3000-ஐச் சரிபார்க்கவும்; Python-க்கு, போர்ட் 8080-ஐச் சரிபார்க்கவும். முதல் தொடக்கத்தின் போது, எம்பெடிங் மாடல் பதிவிறக்கம் முடியும் வரை காத்திருக்கவும். கன்டெய்னர் இயங்குகிறதா என்பதை உறுதிப்படுத்த நீங்கள் docker ps-ஐப் பயன்படுத்தலாம். போர்ட் 3000 ஏற்கனவே பயன்பாட்டில் இருந்தால், -p-ன் இடது பக்கத்தில் உள்ள போர்ட்டை மாற்றவும்.
• மாடல் மெனுவில் உள்ள ஐடி வழங்குநரின் குறுகிய பெயரை விட நீளமானது: மெனுவிலிருந்து முழுமையான ஐடியைப் பயன்படுத்தவும், ஸ்லாஷ்கள் உட்பட.
• புதுப்பித்த பிறகு அனைவரும் வெளியேற்றப்பட்டனர்: WEBUI_SECRET_KEY மாறியது. முதல்முறை உருவாக்கப்பட்ட ரகசியத்தைப் பயன்படுத்தி மறுதொடக்கம் செய்யவும்.
• Verify Connection தோல்வியடைகிறது: முதலில் Advanced-ன் கீழ் மாடல் ஐடியை மேனுவலாகச் சேர்த்து, பின்னர் ஒரு வாக்கிய சாட் மூலம் அதை உறுதிப்படுத்தவும். சில சேவைகள் /models-ஐ வழங்குவதில்லை, எனவே சரிபார்ப்பு பிழையைப் புகாரளிக்கும்போதும் சாட் வேலை செய்யலாம்.
• மாடல் இல்லை: காலாவதியான பெயரைப் பயன்படுத்துவதைத் தொடர்வதற்குப் பதிலாக OmniProxy-ன் தற்போதைய பட்டியலிலிருந்து ஐடியை மீண்டும் நகலெடுக்கவும்.

அதிகாரப்பூர்வ குறிப்புகள்

நிறுவல் கட்டளைகளுக்கு, Open WebUI Quick Start-ஐப் பார்க்கவும். இணைப்பு படிகளுக்கு, OpenAI-compatible connection instructions-ஐப் பார்க்கவும். எடுத்துக்காட்டுகளில் பயன்படுத்தப்படும் மாடல் ஐடிகளுக்கு, Claude model overview மற்றும் Gemini model list-ஐப் பார்க்கவும்.

உங்கள் சொந்த OmniProxy அமைப்பிலிருந்து ஒவ்வொரு ஒதுக்கிடத்தையும் மதிப்புகளால் மாற்றவும். உண்மையான திறவுகோலை எங்கும் பகிர வேண்டாம்.

சேமிக்கப்பட்ட விடை அல்லது HTTP 200 மட்டுமே முழு ஏஜெண்ட் பொருத்தத்தை நிரூபிக்காது. OmniProxy-ன் கோரிக்கைப் பதிவில் மூலம் மற்றும் மாதிரியைச் சரிபார்க்கவும்.

அதிகாரப்பூர்வ மூலங்கள் · Open WebUI ↗