Proksi songsang dan URL base

Letakkan HolyArrs di alamat seperti https://home.example/holyarrs di belakang proksi songsang anda.

Proksi songsang (reverse proxy) ialah pelayan web di hadapan app anda yang menghantar setiap alamat ke kontena yang betul. URL base ialah laluan tempat HolyArrs berada.

Tetapkan laluan

1. Tambah laluan itu ke fail Compose anda:

   services:
     holyarrs:
       environment:
         - HOLYARRS_URL_BASE=/holyarrs

2. Mulakan semula kontena.

3. Tambah peraturan proksi daripada Contoh proksi.

4. Buka https://home.example/holyarrs/. Anda akan nampak halaman log masuk. Settings > This app (Tetapan > App ini) menunjukkan laluan yang digunakan.

Caution

Proksi anda mesti menghantar laluan itu tanpa diubah. Jika ia membuang /holyarrs, setiap halaman menyatakan tidak ditemui.

Pilihan

Di mana hendak menetapkan laluan

Di mana	Bila berkuat kuasa
HOLYARRS_URL_BASE	Semasa mula. Mengatasi yang lain.
Bendera -url-base /holyarrs	Semasa mula, apabila pemboleh ubah tidak ditetapkan.
Settings > This app	Pada permulaan seterusnya, hanya apabila pemboleh ubah dan bendera kedua-duanya tidak ditetapkan.

Contoh proksi

nginx-proxy-manager. Buat proxy host untuk domain anda, kemudian tambah custom location:

• Location: /holyarrs
• Forward hostname holyarrs, port 6262. Tiada garis condong di hujung, atau laluan dibuang.
• Dalam kotak gear lokasi itu:

proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_buffering off;
proxy_read_timeout 1h;

Traefik. Jangan tambah middleware StripPrefix.

labels:
  - traefik.enable=true
  - traefik.http.routers.holyarrs.rule=Host(`home.example`) && PathPrefix(`/holyarrs`)
  - traefik.http.services.holyarrs.loadbalancer.server.port=6262

Caddy. Guna handle. handle_path membuang laluan.

home.example {
  handle /holyarrs* {
    reverse_proxy holyarrs:6262 {
      flush_interval -1
    }
  }
}

Nama hos dan alamat proksi

• Jika orang mencapai HolyArrs melalui nama hos, tambahkannya ke HOLYARRS_ALLOWED_HOSTS.
• Jika proksi menambah X-Forwarded-For, tambah alamat proksi ke HOLYARRS_TRUSTED_PROXIES. Tanpanya, log masuk tidak dapat mengetahui siapa yang berada dalam rangkaian rumah anda.

Jika tidak berfungsi

Gejala	Punca	Penyelesaian
Setiap halaman menyatakan tidak ditemui	Proksi membuang laluan	Buang tetapan strip atau garis condong di hujung.
Kemas kini langsung tidak tiba	Proksi menimbal respons	Matikan penimbalan (proxy_buffering off, flush_interval -1).
Laluan yang disimpan mengunci anda	Laluan yang disimpan salah	Mulakan dengan HOLYARRS_URL_BASE=/ untuk mengabaikannya.
Log masuk menganggap anda di luar rangkaian anda	Proksi tidak dipercayai	Hantar X-Real-IP dan X-Forwarded-For, dan tetapkan HOLYARRS_TRUSTED_PROXIES.

Lebih banyak penyelesaian: Penyelesaian masalah.

Untuk pakar

Peraturan laluan

• Aksara dibenarkan: huruf, digit, -, _, . dan /. Tiada .. atau //.
• holyarrs, /holyarrs dan /holyarrs/ semuanya bermaksud /holyarrs.
• Laluan tersimpan yang tidak sah diabaikan.
• Semuanya berpindah ke bawah laluan itu: halaman, API, kemas kini langsung, log masuk, dan pautan yang HolyArrs bina (pautan jemputan, feed kalendar).
• /healthz dan /readyz turut menjawab di root, jadi semakan kesihatan imej itu sendiri terus berfungsi.
• Mana-mana alamat lain di luar laluan menjawab tidak ditemui.

Apa yang proksi mesti lakukan

Keperluan	Sebab
Hantar laluan tanpa diubah	HolyArrs menghala mengikut laluan penuh.
Kekalkan pengepala Host	Semakan hos dan pautan yang dibina menggunakannya.
Tiada penimbalan respons	Kemas kini langsung dialirkan melalui satu respons yang terbuka.
Tempoh tamat baca yang panjang (1 jam)	Aliran kemas kini langsung kekal terbuka.

Berkaitan

• Pasang
• Log masuk
• Pemboleh ubah persekitaran