ポートとネットワーク設定

概要

本セクションでは、Fess のネットワーク関連の設定について説明します。ポート番号の変更、プロキシ設定、HTTP通信の設定など、ネットワーク接続に関する設定を取り扱います。

使用ポートの設定

デフォルトポート

Fess はデフォルトで以下のポートを使用します。

サービス	ポート番号
Fess ウェブアプリケーション	8080
OpenSearch (HTTP)	9201
OpenSearch (Transport)	9301

Fess ウェブアプリケーションのポート変更

Linux環境での設定

Linux 環境でポート番号を変更する場合は、bin/fess.in.sh を編集します。

FESS_JAVA_OPTS="$FESS_JAVA_OPTS -Dfess.port=8080"

例えば、ポート 80 を使用する場合:

FESS_JAVA_OPTS="$FESS_JAVA_OPTS -Dfess.port=80"

注釈

1024 以下のポート番号を使用する場合は、root 権限または適切な権限設定(CAP_NET_BIND_SERVICE)が必要です。

環境変数による設定

環境変数でポート番号を指定することもできます。

export FESS_PORT=8080

RPM/DEBパッケージの場合

RPMパッケージでは /etc/sysconfig/fess、DEBパッケージでは /etc/default/fess を編集します。

FESS_PORT=8080

Windows環境での設定

Windows 環境では、bin\fess.in.bat を編集します。

set FESS_JAVA_OPTS=%FESS_JAVA_OPTS% -Dfess.port=8080

Windowsサービスとして登録する場合

Windows 環境でサービス登録して使用する場合は、bin\service.bat のポート設定も変更してください。詳細は Windowsサービスへの登録を参照してください。

コンテキストパスの設定

Fess をサブディレクトリで公開する場合、コンテキストパスを設定できます。

FESS_JAVA_OPTS="$FESS_JAVA_OPTS -Dfess.context.path=/search"

この設定により、http://localhost:8080/search/ でアクセスできるようになります。

警告

コンテキストパスを変更した場合、静的ファイルのパスも適切に設定する必要があります。

プロキシ設定

概要

イントラネット内から外部サイトをクロールする場合や、外部APIにアクセスする場合、ファイアウォールによって通信がブロックされることがあります。そのような環境では、プロキシサーバー経由で通信を行う設定が必要です。

クローラー用プロキシの設定

基本設定

管理画面のクロール設定で、設定パラメーターに以下のように指定します。

client.proxyHost=proxy.example.com
client.proxyPort=8080

認証が必要なプロキシの設定

プロキシサーバーで認証が必要な場合は、以下のように追加します。

client.proxyHost=proxy.example.com
client.proxyPort=8080
client.proxyUsername=proxyuser
client.proxyPassword=proxypass

特定のホストをプロキシから除外

特定のホスト(イントラネット内のサーバーなど)をプロキシ経由せずに接続する場合:

client.proxyHost=proxy.example.com
client.proxyPort=8080
client.nonProxyHosts=localhost|*.local|192.168.*

システム全体のHTTPプロキシ設定

Fess アプリケーション全体でHTTPプロキシを使用する場合は、fess_config.properties で設定します。

http.proxy.host=proxy.example.com
http.proxy.port=8080
http.proxy.username=proxyuser
http.proxy.password=proxypass

警告

パスワードは暗号化されずに保存されます。適切なファイルパーミッションを設定してください。

HTTP通信設定

ファイルアップロードの制限

管理画面からのファイルアップロードサイズを制限できます。

設定項目	説明
`http.fileupload.max.size`	最大ファイルアップロードサイズ(デフォルト: 262144000バイト = 250MB)
`http.fileupload.threshold.size`	メモリ上に保持する閾値サイズ(デフォルト: 262144バイト = 256KB)
`http.fileupload.max.file.count`	一度にアップロードできるファイル数(デフォルト: 10)

fess_config.properties での設定例:

http.fileupload.max.size=524288000
http.fileupload.threshold.size=524288
http.fileupload.max.file.count=20

接続タイムアウト設定

OpenSearchへの接続タイムアウトを設定できます。

設定項目	説明
`search_engine.http.url`	OpenSearchのURL(デフォルト: http://localhost:9201)
`search_engine.heartbeat_interval`	ヘルスチェック間隔(ミリ秒、デフォルト: 10000)

OpenSearchの接続先変更

外部のOpenSearchクラスタに接続する場合:

search_engine.http.url=http://opensearch-cluster.example.com:9200

複数ノードへの接続

複数のOpenSearchノードに接続する場合は、カンマ区切りで指定します。

search_engine.http.url=http://node1:9200,http://node2:9200,http://node3:9200

SSL/TLS接続の設定

OpenSearchへHTTPSで接続する場合:

search_engine.http.url=https://opensearch.example.com:9200
search_engine.http.ssl.certificate_authorities=/path/to/ca.crt
search_engine.username=admin
search_engine.password=admin_password

注釈

証明書の検証を行う場合は、certificate_authorities に CA証明書のパスを指定します。

仮想ホスト設定

概要

Fess にアクセスされたホスト名によって、検索結果を出し分けることができます。詳細は仮想ホストを参照してください。

基本設定

fess_config.properties で仮想ホストのヘッダーを設定します。

virtual.host.headers=X-Forwarded-Host,Host

リバースプロキシとの連携

Nginx の設定例

server {
    listen 80;
    server_name search.example.com;

    location / {
        proxy_pass http://localhost:8080;
        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_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Forwarded-Host $host;
    }
}

Apache の設定例

<VirtualHost *:80>
    ServerName search.example.com

    ProxyPreserveHost On
    ProxyPass / http://localhost:8080/
    ProxyPassReverse / http://localhost:8080/

    RequestHeader set X-Forwarded-Proto "http"
    RequestHeader set X-Forwarded-Host "search.example.com"
</VirtualHost>

SSL/TLS終端

リバースプロキシでSSL/TLS終端を行う場合の設定例(Nginx):

server {
    listen 443 ssl http2;
    server_name search.example.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://localhost:8080;
        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_set_header X-Forwarded-Proto https;
        proxy_set_header X-Forwarded-Host $host;
    }
}

ファイアウォール設定

必要なポートの開放

Fess を外部からアクセス可能にする場合、以下のポートを開放します。

iptables の設定例:

# Fess ウェブアプリケーション
iptables -A INPUT -p tcp --dport 8080 -j ACCEPT

# HTTPSでアクセスする場合(リバースプロキシ経由)
iptables -A INPUT -p tcp --dport 443 -j ACCEPT

firewalld の設定例:

# Fess ウェブアプリケーション
firewall-cmd --permanent --add-port=8080/tcp
firewall-cmd --reload

セキュリティグループの設定(クラウド環境)

AWS、GCP、Azureなどのクラウド環境では、セキュリティグループやネットワークACLで適切なポートを開放してください。

推奨設定: - インバウンド: 80/443ポート(HTTPリバースプロキシ経由) - 8080ポートは内部からのみアクセス可能に制限 - OpenSearchの9201/9301ポートは内部からのみアクセス可能に制限

トラブルシューティング

ポート変更後にアクセスできない

Fess を再起動したか確認してください。
ファイアウォールで該当ポートが開放されているか確認してください。
ログファイル(fess.log)でエラーを確認してください。

プロキシ経由でクロールできない

プロキシサーバーのホスト名とポートが正しいか確認してください。
プロキシサーバーで認証が必要な場合、ユーザー名とパスワードを設定してください。
プロキシサーバーのログで接続試行が記録されているか確認してください。
nonProxyHosts の設定が適切か確認してください。

OpenSearchに接続できない

OpenSearchが起動しているか確認してください。
search_engine.http.url の設定が正しいか確認してください。
ネットワーク接続を確認してください: curl http://localhost:9201
OpenSearchのログでエラーを確認してください。

リバースプロキシ経由でアクセスすると正常に動作しない

X-Forwarded-Host ヘッダーが正しく設定されているか確認してください。
X-Forwarded-Proto ヘッダーが正しく設定されているか確認してください。
コンテキストパスが正しく設定されているか確認してください。
リバースプロキシのログでエラーを確認してください。

参考情報

メモリ設定 - メモリ設定
Windowsサービスへの登録 - Windowsサービス設定
仮想ホスト - 仮想ホスト設定
クローラー詳細設定 - クローラー詳細設定
OpenSearch Configuration

メニュー

ポートとネットワーク設定

概要

使用ポートの設定

デフォルトポート

Fess ウェブアプリケーションのポート変更

Linux環境での設定

環境変数による設定

RPM/DEBパッケージの場合

Windows環境での設定

Windowsサービスとして登録する場合

コンテキストパスの設定

プロキシ設定

概要

クローラー用プロキシの設定

基本設定

認証が必要なプロキシの設定

特定のホストをプロキシから除外

システム全体のHTTPプロキシ設定

HTTP通信設定

ファイルアップロードの制限

接続タイムアウト設定

OpenSearchの接続先変更

複数ノードへの接続

SSL/TLS接続の設定

仮想ホスト設定

概要

基本設定

リバースプロキシとの連携

Nginx の設定例

Apache の設定例

SSL/TLS終端

ファイアウォール設定

必要なポートの開放

セキュリティグループの設定(クラウド環境)

トラブルシューティング

ポート変更後にアクセスできない

プロキシ経由でクロールできない

OpenSearchに接続できない

リバースプロキシ経由でアクセスすると正常に動作しない

参考情報