Pemasangan Open WebUI dan Konfigurasi OmniProxy

Open WebUI ialah antara muka sembang yang boleh digunakan pada komputer atau pelayan anda sendiri, malah boleh beroperasi sepenuhnya di luar talian. Ia tidak terikat kepada mana-mana penyedia model: anda boleh menyambungkannya kepada alat seperti Ollama yang menjalankan model secara setempat, atau kepada API yang serasi dengan format OpenAI, iaitu alamat perkhidmatan model yang menggunakan format permintaan yang sama. Dengan cara ini, anda boleh bertukar antara model setempat dan model awan dalam tetingkap yang sama.

Ia sesuai untuk kegunaan jangka panjang oleh pasukan dan organisasi. Keupayaan yang dikemas kini dengan lebih pantas akan diperkenalkan terlebih dahulu dalam Computer, iaitu produk yang digunakan oleh Open WebUI untuk mencuba ciri baharu.

Persediaan sebelum pemasangan

Open WebUI boleh digunakan pada macOS, Linux dan Windows. Anda boleh memasangnya melalui Docker, Python atau Kubernetes. Docker memasang aplikasi dan persekitaran operasinya dalam bekas yang agak terasing, lalu menjadi kaedah yang disyorkan. Jika Docker tidak tersedia, anda juga boleh menggunakan perintah Python yang telah diuji di bawah. Kubernetes ialah sistem untuk menggunakan dan mengurus bekas; lihat Quick Start di bahagian akhir untuk langkah berkaitan.

Disyorkan secara rasmi

Docker

• Satu perintah docker run
• Buka 3000 dalam pelayar
• Data berada dalam volum data

Hanya mahu berbual

Imej slim

• Saiz muat turun lebih kecil
• Tukar tag kepada :slim
• Fungsi sembang masih tersedia

Tidak dihuraikan di sini

Dua pilihan lain

• Pemasangan manual dengan Python
• Penggunaan Kubernetes
• Lihat Quick Start rasmi

Sediakan perkara berikut sebelum bermula:

• Docker yang sudah dipasang dan boleh dijalankan.
• Rentetan rahsia yang hanya digunakan oleh anda. Jalankan openssl rand -hex 32 untuk menjana rentetan tersebut, kemudian masukkannya ke dalam WEBUI_SECRET_KEY. Simpan nilai ini tanpa mengubahnya; jika nilai tersebut ditukar apabila bekas dibina semula, semua pengguna yang telah log masuk akan dilog keluar.
• OmniProxy yang sedang berjalan serta ID model daripada senarai model semasanya. ID model ialah nama penuh yang digunakan untuk memilih model tertentu.

Pemasangan dan pelancaran pertama

Buka terminal dan jalankan perintah daripada Quick Start. Gantikan your-secret-key terlebih dahulu dengan rentetan rahsia yang baru dijana:

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

Pilihan dalam perintah ini mempunyai fungsi berikut:

• -p 3000:8080: membolehkan anda membuka antara muka melalui port 3000 pada komputer ini. Jika port 3000 sedang digunakan, ubah nombor di sebelah kiri.
• -v open-webui:/app/backend/data: menyimpan sembang, pengguna dan tetapan dalam volum data. Volum data ialah lokasi di luar bekas yang menyimpan data untuk jangka panjang. Kandungannya kekal selepas bekas dikemas kini, jadi jangan buang pilihan ini.
• --add-host=host.docker.internal:host-gateway: membolehkan bekas mengakses perkhidmatan lain yang berjalan pada komputer ini.
• --restart always: memulakan semula bekas selepas komputer dihidupkan semula.

Selepas perintah selesai dijalankan, buka http://localhost:3000 dalam pelayar dan cipta akaun pertama mengikut arahan pada halaman.

Jika anda hanya bersembang melalui API, anda boleh menukar tag imej daripada :main kepada :slim. slim ialah imej yang lebih kecil dan tidak mengandungi model suara serta model pembenaman setempat dalam bekas, tetapi antara muka sembang masih boleh digunakan. Jika anda memerlukan keupayaan setempat tersebut, terus gunakan :main.

Untuk mengemas kini secara manual, jalankan docker rm -f open-webui terlebih dahulu, kemudian jalankan docker pull ghcr.io/open-webui/open-webui:main, dan mulakan semula menggunakan perintah docker run yang sama. Volum data dan WEBUI_SECRET_KEY mesti dikekalkan tanpa perubahan.

Jika Docker tidak tersedia

Quick Start turut menyediakan kaedah pemasangan Python. Pada 2026-10-09, perintah berikut digunakan pada macOS untuk memasang Open WebUI v0.11.4 dan menyelesaikan satu perbualan. Komputer tersebut tidak mempunyai Docker Desktop pada waktu itu.

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

Selepas dimulakan, buka http://localhost:8080 dalam pelayar. Ini ialah port yang digunakan oleh kaedah pemasangan Python, bukannya port 3000 untuk Docker.

Semasa pelancaran pertama, satu model pembenaman akan dimuat turun dan proses ini mungkin mengambil masa beberapa minit. Model pembenaman menukarkan teks kepada data yang lebih mudah dicari dan dipadankan. Tunggu sehingga halaman log masuk muncul sebelum meneruskan; akaun pertama yang didaftarkan akan menjadi pentadbir. Bahasa antara muka mengikut tetapan sistem, dan ujian ini memaparkan bahasa Cina Ringkas.

DATA_DIR mesti merujuk kepada direktori yang akan disimpan untuk jangka panjang bagi menyimpan data Open WebUI. Jika tidak ditetapkan, data mungkin disimpan dalam direktori sementara dan hilang selepas aplikasi ditutup. Jika WEBUI_SECRET_KEY tidak ditetapkan, program akan menulis .webui_secret_key dalam direktori semasa. Mulakan program daripada direktori yang ingin dikekalkan atau tetapkan pemboleh ubah ini sendiri.

Mendapatkan parameter sambungan daripada OmniProxy

Salin tiga perkara berikut daripada OmniProxy anda sendiri:

URL:      https://your-omniproxy-origin.example/v1
API Key:  <YOUR_OMNIPROXY_API_KEY>
Model ID: Salin ID penuh daripada senarai model OmniProxy semasa

URL ialah alamat yang digunakan oleh Open WebUI untuk menyambung kepada API dan mesti berakhir dengan /v1. Jangan tambahkan /chat/completions selepasnya kerana bahagian tersebut akan ditambahkan sendiri oleh Open WebUI.

Salin ID model sepenuhnya daripada senarai semasa OmniProxy. Jika ID tersebut mengandungi awalan sumber dan garis miring, kekalkan semuanya. Dua nama pendek di bawah hanyalah rujukan daripada dokumentasi penyedia pada 2026-10-09. Jangan gunakannya jika nama tersebut tiada dalam senarai semasa:

• ID Claude API untuk Claude Sonnet 5.5: claude-sonnet-5-5
• Nama API untuk Gemini 3.8 Flash: gemini-3.8-flash

Jangan masukkan kunci penyedia ke dalam Open WebUI. Jika get laluan tidak mengesahkan kunci, medan kunci API boleh dibiarkan kosong; jangan cipta rentetan kunci lain.

Pelayar

Setempat 3000

• Buka halaman sembang
• Lengkapkan pendaftaran dahulu
• Kemudian pergi ke tetapan

Dalam bekas

Open WebUI

• Jangan tulis localhost
• Gunakan nama hos komputer hos
• URL mesti berakhir dengan /v1

Komputer yang sama

OmniProxy

• Simpan kunci dalam get laluan
• Gunakan senarai model daripada get laluan
• Kemudian lihat rekod panggilan

Jika perkhidmatan model berjalan pada hos, manakala Open WebUI berjalan dalam bekas Docker, gantikan localhost dalam URL dengan host.docker.internal. Hos ialah komputer yang menjalankan Docker secara langsung. Jika OmniProxy hanya mendengar pada komputer ini, URL boleh ditulis sebagai http://host.docker.internal:port/v1, dengan port digantikan oleh port sebenar yang digunakan oleh OmniProxy.

Jika Open WebUI dijalankan secara setempat menggunakan perintah Python dalam bahagian sebelumnya dan OmniProxy juga berada pada komputer yang sama, gunakan 127.0.0.1 atau localhost sebagai alamat. Dalam keadaan ini, jangan gunakan host.docker.internal.

Mengisi konfigurasi alat

Antara muka bahasa Cina Ringkas v0.11.4 pada 2026-10-09 menggunakan nama yang berbeza daripada Settings > Admin > Connections dalam arahan bahasa Inggeris. Ikuti pilihan yang benar-benar dipaparkan dalam antara muka:

1. Kembangkan bar sisi kiri.
2. Klik menu pengguna di bahagian bawah.
3. Klik Tetapan.
4. Dalam kumpulan pentadbir di bahagian bawah, klik Sambungan luaran.
5. Buka API OpenAI.
6. Klik + di sebelah kanan Urus sambungan API OpenAI.
7. Dalam tetingkap Edit sambungan yang muncul, masukkan URL sehingga /v1. Kekalkan jenis API sebagai Chat Completions.
8. Kekalkan Kaedah pengesahan sebagai Kunci (Bearer). Bearer ialah kaedah yang memasukkan kunci API ke dalam permintaan untuk pengesahan identiti. Apabila OmniProxy memberi anda kunci, masukkannya ke dalam Kunci API. Jika get laluan tidak mengesahkan kunci, biarkan medan ini kosong. Pada 2026-10-09, pengesahan dan satu perbualan berjaya dilakukan dengan medan ini dibiarkan kosong.
9. Klik Sahkan sambungan di sebelah URL. Jika OmniProxy menyediakan /models, senarai model akan diperoleh di sini.
10. Buka Lanjutan. Jika ID model dibiarkan kosong, semua model yang dikembalikan oleh /models pada alamat tersebut akan digunakan. Hanya jika pengesahan gagal, masukkan ID penuh daripada senarai dalam Tambah ID model, kemudian klik Tambah. Tambahkan setiap ID sekali sahaja; ruang kosong di awal dan akhir akan dibuang.
11. Klik Simpan dalam tetingkap ini, kemudian klik Simpan di penjuru kanan bawah halaman sambungan luaran.

Menyimpan konfigurasi sahaja tidak menggantikan proses pengesahan. Sahkan sambungan menghantar permintaan kepada /models, iaitu API yang digunakan untuk menyenaraikan model yang tersedia. Sesetengah perkhidmatan tidak mempunyai API ini, jadi pengesahan mungkin memaparkan ralat walaupun sembang masih boleh digunakan. Dalam keadaan ini, tambahkan ID model secara manual.

Mengesahkan tugas sebenar

Kembali ke halaman sembang, buka menu model di sebelah kotak input dan pilih ID penuh daripada senarai OmniProxy. Hantar ayat yang sangat pendek, contohnya minta model membalas dengan satu perkataan sahaja. Balasan mesti benar-benar muncul dalam kotak sembang.

Pada 2026-10-09, perbualan ini diselesaikan menggunakan pemasangan Python bagi v0.11.4. Docker masih merupakan kaedah yang disyorkan, tetapi ujian ini tidak diulang dalam Docker.

Seterusnya, buka rekod panggilan OmniProxy dan sahkan sumber permintaan serta ID model yang digunakan. Sambungan belum dianggap selesai jika anda hanya melihat konfigurasi berjaya disimpan atau model muncul dalam menu.

Antara muka

Model boleh dipilih

• Connections telah disimpan
• Model muncul dalam senarai
• Hantar satu soalan ringkas

Respons

Kotak sembang mempunyai jawapan

• Bukan mesej kosong
• Bukan ralat sambungan
• Cuba sekali lagi dengan model lain

Rekod

Kelihatan dalam get laluan

• Sumbernya ialah sambungan ini
• ID model sepadan
• Tiada kunci dimasukkan ke halaman

Ralat lazim

• localhost atau 127.0.0.1 digunakan dalam bekas: kedua-dua alamat ini merujuk kepada bekas itu sendiri, bukannya hos. Tukarkannya kepada host.docker.internal dan pastikan perintah pelancaran mengandungi --add-host=host.docker.internal:host-gateway. Jika Open WebUI tidak berada dalam bekas, lakukan sebaliknya dan gunakan alamat setempat.
• Pelayar tidak dapat membuka halaman: semak port 3000 untuk Docker dan port 8080 untuk Python. Semasa pelancaran pertama, tunggu sehingga model pembenaman selesai dimuat turun. docker ps boleh digunakan untuk mengesahkan sama ada bekas sedang berjalan. Jika port 3000 sedang digunakan, ubah port di sebelah kiri -p.
• ID dalam menu model lebih panjang daripada nama pendek penyedia: gunakan ID penuh dalam menu, termasuk semua garis miring di dalamnya.
• Semua pengguna dilog keluar selepas kemas kini: WEBUI_SECRET_KEY telah berubah. Mulakan semula menggunakan rentetan rahsia yang dijana kali pertama.
• Sahkan sambungan gagal: tambahkan ID model secara manual dalam Lanjutan, kemudian sahkan menggunakan satu perbualan sebenar. Sesetengah perkhidmatan tidak mempunyai /models, jadi sembang mungkin masih boleh digunakan walaupun pengesahan memaparkan ralat.
• Model tidak wujud: salin semula ID daripada senarai semasa OmniProxy dan jangan terus menggunakan nama yang sudah lapuk.

Rujukan rasmi

Lihat Open WebUI Quick Start untuk perintah pemasangan. Lihat arahan sambungan OpenAI-compatible untuk langkah sambungan. ID model yang digunakan sebagai contoh boleh dirujuk dalam gambaran keseluruhan model Claude dan senarai model Gemini.

Gantikan setiap penanda tempat dengan nilai dari konfigurasi OmniProxy anda sendiri. Jangan pernah terbitkan kunci sebenar.

Hasil tersimpan atau HTTP 200 sahaja tidak membuktikan keserasian Agen penuh. Semak sumber dan model dalam rekod panggilan OmniProxy.

Sumber rasmi · Open WebUI ↗