Lucee Admin: panduan tetapan pelayan dari A hingga Z

Lucee Admin: panduan tetapan pelayan dari A hingga Z

Penulis: Thalhah · Tarikh: 16 Oktober 2026

Lucee Admin ialah panel kawalan web yang mengawal keseluruhan enjin Lucee CFML. Ia bukan satu panel: setiap pemasangan datang dengan dua admin, Server Admin dan Web Admin, dan banyak masalah konfigurasi berpunca daripada menyunting tetapan pada admin yang salah. Artikel ini memandu anda masuk ke kedua-duanya, mengenal tetapan penting, memilih nilai selamat untuk pelayan kecil, dan melindungi panel ini daripada tangan luar.

Cara Masuk ke Lucee Admin

Kedua-dua panel tinggal di bawah laluan /lucee/admin/. Dua URL ini yang anda perlu ingat:

• Server Admin: http://<pelayan-anda>/lucee/admin/server.cfm
• Web Admin: http://<pelayan-anda>/lucee/admin/web.cfm

Kali pertama dibuka, Lucee meminta anda menetapkan kata laluan admin. Lucee tiada kata laluan lalai, jadi jangan biarkan panel terbuka: sesiapa yang tahu URL itu boleh mengambil alih pelayan. Set kata laluan yang kuat, dan jika anda memasang melalui skrip atau Docker, tetapkan ia lebih awal melalui pemboleh ubah persekitaran LUCEE_PASSWORD supaya panel tidak terdedah walaupun seminit. Jika enjin anda belum siap, rujuk panduan memasang Lucee.

Server Admin Lawan Web Admin

Perbezaan kedua-duanya ialah skop:

• Server Admin mengawal konteks pelayan, iaitu tetapan yang dikongsi semua laman web pada enjin ini.
• Web Admin mengawal satu konteks web, iaitu satu laman web sahaja.

Satu pelayan boleh menghoskan banyak laman web, setiap satu dengan Web Admin sendiri. Apabila satu tetapan wujud pada kedua-dua peringkat, nilai Web Admin menang untuk laman itu. Peraturan praktikal: perkara kongsi seperti datasource, mapping dan kata laluan admin pada Server Admin; perkara khusus satu aplikasi pada Web Admin aplikasi itu.

Kumpulan Tetapan Yang Penting

Panel kiri Lucee Admin menyusun tetapan dalam kumpulan. Ini yang paling kerap anda sentuh:

Datasource (Services > Datasource). Daftar sambungan pangkalan data bernama: MySQL, PostgreSQL, MSSQL, dan sebagainya. Nama yang anda beri ialah nilai pada atribut datasource dalam cfquery. Langkah penuh ada dalam panduan konfigurasi datasource.

Mail (Services > Mail). Tetapan SMTP lalai untuk cfmail: hos, port, nama pengguna, kata laluan, dan pilihan TLS atau SSL. Pada Lucee 7.1 ke atas, fungsi mel dipindahkan ke sambungan Mail yang masih dibundel dalam JAR penuh.

Mappings (Archives & Resources > Mappings). Pemetaan laluan logik kepada laluan fizikal. Mapping khusus aplikasi lebih baik ditakrifkan dalam Application.cfc supaya ia bergerak bersama kod anda.

Scheduled Tasks (Services > Scheduled Tasks). Tugas berjadual cfschedule yang berjalan tanpa menunggu pelawat. Semak lognya supaya tugas gagal tidak terbiar.

Security dan Password (Security > Password dan Security > Access). Password menetapkan kata laluan admin; Access menentukan siapa boleh membuka panel: terbuka, tertutup, localhost sahaja, atau token URL.

Caching (Settings > Caching dan Services > Cache). Settings > Caching mengawal caching templat, query dan fungsi; Services > Cache mengurus cache bernama seperti EHCache dan Redis.

Performance (Settings > Performance dan Settings > Memory). Tetapan pengkompil dan saiz timbunan JVM. Tukar timbunan JVM hanya selepas mengukur, kerana ia memerlukan mula semula.

Logging (Services > Logging). Senarai fail log dan arasnya: application, exception, scheduler, dan remote client.

Extension (Extension > Applications dan Extension > Providers). Pasang dan kemas kini sambungan. Pada Lucee 7, Mail, FTP dan Compress diuruskan dari sini.

Banyak tetapan ini juga boleh ditakrifkan per aplikasi dalam Application.cfc, dan nilainya menimpa nilai admin:

component {
    this.name = "kedai";
    this.datasource = "app_db";
    this.mappings["/model"] = expandPath("./model");
}

Jadual Tetapan untuk Pelayan Kecil

Jadual ini merumuskan tetapan penting, lokasinya, kesannya, dan nilai permulaan yang munasabah untuk pelayan kecil:

Tetapan Yang Selamat Diubah dan Yang Tidak

Yang selamat diubah terus: tambah atau sunting datasource, tambah mapping, tambah tugas berjadual, togol caching, tukar aras log, tetapkan SMTP, dan tukar kata laluan admin. Semua ini berkuat kuasa serta-merta dan mudah dibatalkan.

Yang perlu berhati-hati: menukar saiz timbunan JVM memerlukan mula semula dan boleh menjatuhkan pelayan, menukar Access kepada terbuka mendedahkan panel, memadam datasource yang dipakai memutuskan aplikasi serta-merta, dan membuang sambungan yang dipakai mematahkan kod itu. Peraturan mudah: yang mudah dibatalkan, ubah terus; yang memerlukan mula semula, sandar dahulu dan lakukan di luar waktu sibuk.

Sandar lucee-server.xml Sebelum Mengubah

Setiap perubahan pada Server Admin ditulis ke lucee-server.xml, dan perubahan pada Web Admin ke lucee-web.xml.cfm. Fail ini ialah sumber kebenaran konfigurasi anda. Sebelum menyunting apa-apa yang besar, salin fail pelayan dahulu:

cp /opt/tomcat/lucee-server/context/lucee-server.xml \
   /opt/tomcat/lucee-server/context/lucee-server.xml.bak-$(date +%F)

Laluan berbeza mengikut pemasangan. Pada Tomcat standard, fail pelayan tinggal di bawah lucee-server/context/, manakala fail web di WEB-INF/lucee/. Dengan salinan ini, sebarang kesilapan boleh dipulihkan dengan menyalin semula fail asal dan memulakan semula Lucee.

Simpan Konfigurasi dalam Git

Fail XML ini kecil dan jarang berubah, jadi ia calon sempurna untuk git. Masukkan lucee-server.xml dan lucee-web.xml.cfm ke dalam repo projek, dan commit setiap kali anda mengubah tetapan. Ini memberi sejarah perubahan, semakan git diff, dan cara memindahkan konfigurasi ke pelayan lain dengan yakin.

Dua amaran: kata laluan datasource disimpan dalam fail ini, terenkripsi oleh Lucee tetapi tetap sensitif, jadi jangan tolak repo ke tempat awam. Jangan commit salinan .bak; tambah coraknya kepada .gitignore.

Kunci Admin kepada IP Melalui Hadapan

Jangan biarkan admin terbuka kepada internet. Selain kata laluan, kunci laluan /lucee/admin/ kepada IP tertentu di pelayan hadapan supaya permintaan luar ditolak sebelum sampai ke Lucee. Dengan nginx:

location /lucee/admin/ {
    allow 203.0.113.10;   # ganti dengan IP pejabat anda
    deny all;
    proxy_pass http://127.0.0.1:8888;
}

Dengan Traefik, guna middleware IPWhitelist:

labels:
  - "traefik.http.middlewares.admin-whitelist.ipwhitelist.sourcerange=203.0.113.10"
  - "traefik.http.routers.app.middlewares=admin-whitelist"

Jika anda perlu mengurus dari mana-mana, akses melalui VPN atau terowong SSH, bukan membuka panel. Sahkan kunci itu berfungsi dengan meminta URL admin dari luar:

curl -s -o /dev/null -w '%{http_code}\n' https://contoh.com/lucee/admin/server.cfm

Jawapan 403 atau 404 bermakna hadapan menolak permintaan; 200 bermakna panel masih terbuka.

Jangan Dedahkan Versi Lucee

Halaman log masuk admin dan halaman ralat Lucee memaparkan nombor versi enjin. Penyerang menggunakan nombor versi untuk mencari kelemahan yang diketahui, jadi semakin kurang maklumat yang bocor, semakin sukar kerja mereka. Dua langkah murah: jangan dedahkan admin kepada umum seperti di atas, dan gantikan halaman ralat lalai dengan halaman mesra melalui onError dalam Application.cfc supaya versi dan timbunan tidak tercetak kepada pelawat. Prinsip ini sama seperti dalam panduan keselamatan web XSS dan CSRF, dan cara membaca halaman ralat dengan selamat ada dalam panduan ralat HTTP 500.

Soalan Lazim (FAQ)

Apakah URL untuk masuk ke Lucee Admin?

Server Admin di /lucee/admin/server.cfm, Web Admin di /lucee/admin/web.cfm. Kali pertama dibuka, Lucee meminta kata laluan admin.

Apakah perbezaan Server Admin dan Web Admin?

Server Admin mengawal seluruh pelayan dan semua laman web di atasnya. Web Admin mengawal satu laman web, dan nilainya menimpa nilai pelayan.

Di manakah tetapan Lucee disimpan?

Tetapan Server Admin dalam lucee-server.xml, tetapan Web Admin dalam lucee-web.xml.cfm di bawah WEB-INF/lucee/.

Bagaimana cara mengunci Lucee Admin kepada IP tertentu?

Guna nginx atau Traefik untuk menolak laluan /lucee/admin/ kecuali daripada IP yang dibenarkan, selain kata laluan yang kuat.

Adakah selamat mengubah saiz timbunan JVM dari admin?

Ia memerlukan mula semula dan boleh menjatuhkan pelayan jika nilainya salah. Sandar dahulu, ukur keperluan, dan lakukan di luar waktu sibuk. Butiran dalam panduan tala JVM Lucee.

Sumber

• CFAdmin documentation, docs.lucee.org
• Lucee Server & web servers, docs.lucee.org
• Configuration: Lucee web.xml, docs.lucee.org
• Lucee 7.1 new features, docs.lucee.org
• Lucee Configuration Files for Tomcat, gist

Senarai semak

Sebelum dan selepas menyentuh Lucee Admin, semak senarai ini:

• [ ] Set kata laluan admin yang kuat, unik untuk pelayan ini.
• [ ] Sahkan anda pada admin yang betul: Server Admin untuk tetapan kongsi, Web Admin untuk satu aplikasi.
• [ ] Salin lucee-server.xml dan lucee-web.xml.cfm sebelum setiap perubahan besar.
• [ ] Daftar datasource dan uji sambungannya sebelum dipakai dalam kod.
• [ ] Hidupkan caching untuk pengeluaran, matikan semasa pembangunan.
• [ ] Semak tugas berjadual dan lognya supaya tiada tugas gagal terbiar.
• [ ] Kunci /lucee/admin/ kepada IP yang dibenarkan pada nginx atau Traefik.
• [ ] Gantikan halaman ralat lalai supaya versi Lucee tidak terdedah.
• [ ] Commit kedua-dua fail XML ke git, tanpa salinan .bak dan tanpa repo awam.