Algernon

アクセス

• ブラウザを開く: https://<SERVER-IP>
• TLS 証明書は自己署名のため、初回アクセス時にブラウザーの証明書警告を承認してください。
• 通常の HTTP は自動的に HTTPS へリダイレクトされます: http://<SERVER-IP>

コンテンツの公開

Web サイトのファイルは次の場所に配置します: /srv/algernon

Algernon がサポートする形式:

• HTML ファイル: そのまま配信
• Markdown ファイル: 自動でレンダリング
• Lua ページ: 動的ページとして実行されます。対象は index.lua and other .lua files

重要なファイルとディレクトリ

• バイナリ: /usr/local/bin/algernon
• Web ルート: /srv/algernon
• TLS 証明書: /etc/algernon/cert.pem
• TLS 秘密鍵: /etc/algernon/key.pem
• Bolt データベース: /var/lib/algernon/algernon.db
• systemd ユニット: /etc/systemd/system/algernon.service

サービス管理

Algernon は systemd サービスとして動作し、起動時に自動的に開始します。

サービスのステータスを確認します:

systemctl status algernon

Web サイトのファイルを編集しても変更がすぐに反映されない場合は、Algernon を再起動してください:

systemctl restart algernon

サービスのログを表示:

journalctl -u algernon -f

付属の systemd サービスを使わない場合は、停止して無効化してください:

systemctl disable --now algernon

その後は Algernon を手動で実行するか、独自の systemd サービスを作成できます。利用可能なコマンドラインオプションは次で確認します:

algernon -h

注意事項

• Algernon は専用の algernon system user.
• Files added to /srv/algernon should be accessible to the algernon ユーザー
• Web ルート内のファイルで権限の問題が発生した場合は、所有者が次であることを確認してください algernon: chown -R algernon:algernon /srv/algernon
• HTTPS と HTTP/2 は Algernon が直接有効にします。
• HTTP のトラフィックは HTTPS へリダイレクトされます。
• このサービスがバインドするポートは 80 と 443 without running as root.