Sa2web

日本語

简体中文
English
Français
Español
Русский
Bahasa Indonesia
Tiếng Việt

日本語

简体中文
English
Français
Español
Русский
Bahasa Indonesia
Tiếng Việt

Appearance

製品のデプロイ ​

目的 ​

インストールスクリプトを使用して Sa2web をデプロイし、初回インストール、アップグレード、検証、HTTPS 設定を完了します。

前提条件 ​

  • デプロイ先サーバーは Linux x86_64 アーキテクチャである必要があります。現在の製品は Windows、macOS、ARM64、その他の CPU アーキテクチャ環境をサポートしていません。
  • Docker と Docker Compose がインストール済みである。
  • インストールパス、ホスト内網 IP、公開 IP またはドメイン、システム名、system ユーザーのパスワードを準備している。

参考動画 ​

手順の確認には、インストール参考動画を参照してください。

ダウンロード ​

公式サイトから必要な team 版または full 版をダウンロードし、任意のディレクトリへ展開します。

bash
cd /opt && tar -xzf browser_full_1.0.0.tar.gz

操作手順 ​

  1. デプロイディレクトリに入り、インストールスクリプトを実行します。
bash
cd /opt/browser_full_1.0.0
chmod +x install.sh
./install.sh
  1. インストール言語を選択します。スクリプトは English、简体中文、日本語、Tiếng Việt、Bahasa Indonesia、Español、Français、Русский をサポートします。
  2. ソフトウェア利用規約を読み、同意します。
  3. 初回インストール時に、プロンプトに従って次の値を入力します。
パラメータ説明デフォルト
インストールディレクトリ製品の実行ディレクトリ/opt/sa
ホスト内網 IPコンテナとサービスのバインドに使用する。localhost や 127.0.0.1 は入力しない必須
ホスト公開 IP外部アクセスに使用内網 IP
システムアクセスドメインユーザーがアクセスするドメインまたは IP公開 IP
システム名フロントエンド表示名App System
system ユーザーパスワード初期 system ユーザーのパスワードabc123456
  1. HTTPS/SSL 証明書方式を選択します。
  • Caddy で Let's Encrypt などの無料証明書を自動取得する。
  • Caddy 自己署名証明書を使用する。
  • 独自証明書を提供し、volumes/ssl に配置する。

Caddy 自己署名証明書を選択した場合、クライアント端末に Caddy ローカルルート証明書をインストールする必要があります。手順は内部証明書のインストールを参照してください。

  1. スクリプトはオフラインイメージを読み込み、docker-compose.yml を生成し、実行設定を書き込み、コンテナを起動します。

アップグレード ​

  1. 現在のインストールディレクトリ、特に volumes/、data/、logs/ をバックアップします。
bash
tar czf /tmp/browser_backup_$(date +%F).tgz $INSTALL_PATH
  1. 新バージョンのデプロイファイルを対象サーバーへコピーする。
  2. 新バージョンディレクトリで ./install.sh を実行する。
  3. スクリプトが $HOME/.sa/config.env を検出するとアップグレードモードに入り、設定を再生成して次を実行します。
bash
docker compose down
docker compose up -d

結果検証 ​

bash
docker compose -f $INSTALL_PATH/docker-compose.yml ps
tail -n 200 $INSTALL_PATH/logs/app/app.log
docker compose -f $INSTALL_PATH/docker-compose.yml logs --tail 200 --follow

ブラウザーでアクセスします。

text
https://<APP_DOMAIN>/
https://<APP_DOMAIN>/admin/login

インストール後の初期化 ​

  1. system ユーザーで管理コンソールにログインする。
  2. デフォルトパスワード abc123456 を使用している場合は、ただちに変更し、予備の管理者を少なくとも 1 つ作成する。
  3. ライセンスを取得して追加する。手順はライセンス登録を参照してください。
  4. システム名、ドメイン、基本設定を確認する。
  5. マシンとブラウザーインスタンスを作成する。
  6. テストユーザー、テストサイト、テストグループを作成する。
  7. ユーザーポータルから 1 回サイトアクセス検証を完了する。入口は次のとおりです。
text
https://<APP_DOMAIN>/app

バックアップ推奨事項 ​

データ推奨事項
インストールディレクトリアップグレード前に $INSTALL_PATH 全体をバックアップする
volumes証明書、設定、オブジェクトストレージなどの実行データを保存する
dataアップロード画像、Caddy 証明書、ClickHouse、Garage、GeoIP、ブラウザー関連実行データを保存する
logsトラブルシューティングと監査に必要なログを保存する
データベース企業ポリシーに従って定期バックアップする
.sa 設定$HOME/.sa/config.env と $HOME/.sa/user.env を保存する

よくある質問 ​

  • 自動証明書には、公開ドメインがサーバーを正しく指し、80/443 ポートが開放されている必要があります。
  • 内網デプロイで Caddy 自己署名証明書を使用する場合、$INSTALL_PATH/data/caddy/pki/authorities/local/root.crt をアクセス端末の信頼済みルート証明書ストアへインストールしてください。
  • 独自証明書は cert.crt と cert.key という名前にし、インストールディレクトリの volumes/ssl に配置してください。
  • 地理位置統計には bash update_geolite2.sh で GeoLite2 データベースをダウンロードする必要があります。ダウンロードに失敗する場合は、update_geolite2.sh にプロキシを設定してください。
  • インストールが中断した場合は、まず Docker イメージが読み込まれたか確認し、次にインストールディレクトリと $HOME/.sa の既存設定を確認してください。
  • アップグレードではなく完全に再インストールする場合は、$HOME/.sa を削除してから install.sh を再実行してください。

Sa2web 1.0.0

Copyright © 2026