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

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

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

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

Open WebUI macOS, Linux மற்றும் Windows-ல் கிடைக்கிறது. நீங்கள் Docker, Python அல்லது Kubernetes-ஐப் பயன்படுத்தி இதை நிறுவலாம். Docker பயன்பாடு மற்றும் அதன் இயக்க சூழலை ஒப்பீட்டளவில் தனிமைப்படுத்தப்பட்ட கொள்கலனில் (container) தொகுக்கிறது மற்றும் இது பரிந்துரைக்கப்பட்ட முறையாகும். 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 என்பது கொள்கலனுக்குள் உள்ளூர் பேச்சு மற்றும் உட்பொதித்தல் (embedding) மாடல்களை உள்ளடக்கிய சிறிய இமேஜ் ஆகும், ஆனால் அரட்டை இடைமுகம் தொடர்ந்து கிடைக்கும். அந்த உள்ளூர் திறன்கள் உங்களுக்குத் தேவைப்பட்டால் :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 அன்று, Open WebUI v0.11.4-ஐ நிறுவவும் ஒரு உரையாடலை முடிக்கவும் macOS-ல் பின்வரும் கட்டளை பயன்படுத்தப்பட்டது. அந்த நேரத்தில் அந்த கணினியில் 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 ஐடி: 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-ன் கோரிக்கை பதிவுகளைத் திறந்து, இந்த கோரிக்கைக்கான ஆதாரம் மற்றும் மாடல் ஐடியை உறுதிப்படுத்தவும். வெற்றிகரமான சேமிப்பைப் பார்ப்பது அல்லது மெனுவில் மாடலை மட்டும் பார்ப்பது முடிவடைந்ததாகக் கருதப்படாது.

இடைமுகம்

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

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

பதில்

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

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

பதிவுகள் (Logs)

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 ↗