(configuring-an-apache-proxy)=
# 設定 Apache 代理
Evennia有它自己的webserver。通常不應更換它。但是想要使用像 Apache 這樣的外部 webserver 的另一個原因是充當 Evennia webserver 前面的*代理*。使用 TLS(加密)來實現此功能需要本頁末尾介紹的一些額外工作。
```{warning} 可能已經過時了
下面的 Apache 說明可能已過時。如果出現問題,或者您在不同的伺服器上使用 Evennia,請告訴我們。
```
(running-apache-as-a-proxy-in-front-of-evennia)=
## 在 Evennia 前面執行 Apache 作為代理
以下是使用前端代理程式 (Apache HTTP) 執行 Evennia 的步驟,`mod_proxy_http`,
`mod_proxy_wstunnel` 和 `mod_ssl`。 `mod_proxy_http` 和 `mod_proxy_wstunnel` 只是
下面簡稱`mod_proxy`。
(install-mod_ssl)=
### 安裝`mod_ssl`
- *Fedora/RHEL* - Apache HTTP Server 和 `mod_ssl` 在 Fedora 和 RHEL 的標準套件儲存庫中可用:
```
$ dnf install httpd mod_ssl
or
$ yum install httpd mod_ssl
```
- *Ubuntu/Debian* - Apache HTTP Server 和 `mod_sslj`kl 一起安裝在 `apache2` 軟體包中,並在 Ubuntu 和 Debian 的標準軟體包儲存庫中提供。安裝後需啟用`mod_ssl`:
```
$ apt-get update
$ apt-get install apache2
$ a2enmod ssl
```
(tls-proxywebsocket-configuration)=
### TLS代理+websocket設定
以下是 Evennia 的範例設定,其中TLS-啟用了 http 和 websocket 代理程式。
(apache-http-server-configuration)=
#### Apache HTTP 伺服器設定
```
# Always redirect to https/443
ServerName mud.example.com
Redirect / https://mud.example.com
ServerName mud.example.com
SSLEngine On
# Location of certificate and key
SSLCertificateFile /etc/pki/tls/certs/mud.example.com.crt
SSLCertificateKeyFile /etc/pki/tls/private/mud.example.com.key
# Use a tool https://www.ssllabs.com/ssltest/ to scan your set after setting up.
SSLProtocol TLSv1.2
SSLCipherSuite HIGH:!eNULL:!NULL:!aNULL
# Proxy all websocket traffic to port 4002 in Evennia
ProxyPass /ws ws://127.0.0.1:4002/
ProxyPassReverse /ws ws://127.0.0.1:4002/
# Proxy all HTTP traffic to port 4001 in Evennia
ProxyPass / http://127.0.0.1:4001/
ProxyPassReverse / http://127.0.0.1:4001/
# Configure separate logging for this Evennia proxy
ErrorLog logs/evennia_error.log
CustomLog logs/evennia_access.log combined
```
(evennia-secure-websocket-configuration)=
#### Evennia 安全 websocket 設定
設定 Evennia 時有一個小技巧,以便 websocket 流量能夠由
代理。您必須在 `mymud/server/conf/settings.py` 檔案中設定 `WEBSOCKET_CLIENT_URL` 設定:
```
WEBSOCKET_CLIENT_URL = "wss://external.example.com/ws"
```
上面的設定是客戶端瀏覽器實際使用的設定。請注意,使用 `wss://` 是因為我們的客戶端將透過加密連線進行通訊(「wss」表示基於 SSL/TLS 的 Websocket)。另外,請特別注意 URL 末端的附加路徑 `/ws`。就是這樣
Apache HTTP 伺服器識別出應將特定請求代理到 Evennia 的 websocket
port 但這也應該適用於其他型別的代理人(如 nginx)。
(run-apache-instead-of-the-evennia-webserver)=
## 執行 Apache 而不是 Evennia webserver
```{warning} 不支援也不建議這樣做。
這是因為有人問過這個問題。 webclient 不起作用。它還會在程式外執行,導致競爭條件。這不受直接支援,因此如果您嘗試這樣做,您就得靠自己了。
```
(install-mod_wsgi)=
### 安裝`mod_wsgi`
- *Fedora/RHEL* - Apache HTTP 伺服器和 `mod_wsgi` 在標準套件中可用
Fedora 和 RHEL 的儲存庫:
```
$ dnf install httpd mod_wsgi
or
$ yum install httpd mod_wsgi
```
- *Ubuntu/Debian* - Apache HTTP 伺服器和 `mod_wsgi` 在標準套件中可用
Ubuntu 和 Debian 的儲存庫:
````
$ apt-get 更新
$ apt-get 安裝 apache2 libapache2-mod-wsgi
````
(copy-and-modify-the-vhost)=
### 複製並修改VHOST
安裝`mod_wsgi`後,將`evennia/web/utils/evennia_wsgi_apache.conf`檔案複製到您的
apache2 vhosts/sites 資料夾。在 Debian/Ubuntu 上,這是 `/etc/apache2/sites-enabled/`。讓你的
將檔案複製到那裡**之後**進行修改。
閱讀註釋並更改路徑以指向設定中的適當位置。
(restartreload-apache)=
### 重新啟動/重新載入 Apache
更改設定後,您需要重新載入或重新啟動 apache2。
- *Fedora/RHEL/Ubuntu*
```
$ systemctl restart httpd
```
- *Ubuntu/Debian*
```
$ systemctl restart apache2
```
運氣好的話,您將能夠將瀏覽器指向您設定的網域或子網域
您的虛擬主機並檢視漂亮的預設 Evennia 網頁。如果沒有,請閱讀希望提供資訊的錯誤
訊息和工作從那裡開始。問題可直接傳送至我們的 [Evennia 社群
站點](https://evennia.com)。
(a-note-on-code-reloading)=
### 關於程式碼重新載入的說明
如果您的 `mod_wsgi` 設定為在守護程式模式下執行(Debian 和
Ubuntu),您可以使用 `touch` 指令告訴 `mod_wsgi` 重新載入
`evennia/game/web/utils/apache_wsgi.conf`。當`mod_wsgi`看到檔案修改時間已經
更改後,它將強制重新載入程式碼。對程式碼的任何修改都不會傳播到
您網站的即時例項,直到重新載入。
如果您沒有以守護程式模式執行或想要強制解決該問題,只需重新啟動或重新載入 apache2
應用您的更改。
(further-notes-and-hints)=
### 進一步的註釋和提示:
如果您從 Apache 收到奇怪的(通常是無訊息的)`Permission denied` 錯誤,請確保
您的 `evennia` 目錄位於 webserver 實際可存取的位置。例如,
某些 Linux 發行版可能預設對使用者的 `/home` 具有非常嚴格的存取許可權
目錄。
一位使用者評論說,他們必須將以下內容新增到 Apache 設定中才能正常運作。
尚未證實,但如果出現問題值得嘗試。
/evennia/game/web">
Options +ExecCGI
Allow from all