クイックデプロイ
ページガイド
デプロイの入口と最小フロー
- まずサーバーの OS、Docker、Docker Compose、ポート開放、ライセンス証明書、インストールパッケージを確認します。
- クイック体験はワンクリックスクリプトを優先します。納品環境や二次開発環境では docker-compose 方式を推奨します。バックエンドの jar とフロントエンドの静的ファイルを置き換えやすいためです。
- サービス起動後、コンテナ、バックエンドログ、データベース、キャッシュ、MQTT、Web ページ、ライセンスページの順で検収します。
- 最後に MQTTX で製品、デバイス、データ送信、指令送信のリンクを一通り実行し、デプロイ環境が実際の業務を支えられることを確認します。
- サーバーで 80、1883、8083、5061、30000-30100/tcp/udp などの業務ポートが開放されていること。
- 商用版のデプロイ前にライセンス証明書とインストールパスワードを用意し、デプロイ完了後にライセンス情報の設定が必要であることを確認していること。
- 二次開発後の再デプロイでは、まず
/var/data配下のバックエンド jar パッケージとフロントエンドvueディレクトリが最新バージョンかを確認すること。
提示
- 商用版はデプロイ完了後、システムにログインし、ホームページでまずライセンス情報を設定（中国語）しないと正常に使用できません
- 二次開発後の再デプロイでは、
/var/dataディレクトリ配下の対応する fastbee-admin.jar パッケージと vue ディレクトリの内容を置き換えるだけです
1. クイックデプロイスクリプト
ワンクリックデプロイスクリプトは docker ベースで作成されており、docker と docker-compose のインストールが必要です。実際の操作フローは以下の docker-compose デプロイ方式と同様で、1 つのスクリプトに統合されており、1 つのコマンドでデプロイが完了します。 コマンドは以下のとおりです：
sudo wget -c https://hub.fastbee.cn/resource/install.sh && bash ./install.sh
注意事項：
- スクリプトにはオープンソース版と商用版が含まれます。商用版はライセンス取得ユーザーのみを対象とし、インストールにはパスワードと証明書が必要です（カスタマーサービスに連絡して取得）
- デプロイ中のファイルダウンロードには比較的時間がかかります。インストール中は docker 公式イメージの使用を推奨します。スクリプトはミラー加速を自動設定するため、比較的高速です
- サーバーで対応するポートを開放してください（例：80、1883、8083、5061、30000-30100/tcp/udp など）
2. docker-compose クイックデプロイ
docker-compose でデプロイするには、サーバーに docker と docker-compose を事前にインストールする必要があります
docker-compose はプロジェクトが依存するアプリケーションと環境をサーバーまたはローカルにまとめてインストールします。以下の手順を実行してインストールとデプロイを完了します：
1. ファイルのアップロード
まず FastBee リポジトリの docker/data/ フォルダをサーバーまたはローカルの /var/ ディレクトリにアップロードします。商用版はバックエンドとフロントエンドを再パッケージ化する必要があり、バックエンドは /var/data/java/ ディレクトリにアップロードして jar ファイルを置き換え、フロントエンドは /var/data/nginx/vue/ ディレクトリにアップロードして中身を置き換えます。
2. デプロイ開始
サーバーまたはローカルの /var/data/ ディレクトリに移動して docker-compose up -d を実行し、完了を待ちます
3. システムへのアクセス
- デプロイ完了後、サーバーアドレスから FastBee IoT プラットフォームにアクセスします。デフォルトアカウントは
admin admin123 - デプロイでは emqx を使用しており、18083 ポートから EMQX コンソールにアクセスできます。デフォルトのアカウントとパスワードは
admin admin123
提示
- 今後プロジェクトを再デプロイする場合は、
fastbee-admin.jarファイルとvueディレクトリの内容を置き換えるだけです - mysql コンテナの初期化には時間がかかります。バックエンドがエラーを報告する場合は
docker restart javaでバックエンドを再起動できます - クイックデプロイのデフォルトアカウント：
- システム管理者：admin admin123
- mysql：root fastbee
- redis：fastbee
- emqx コンソール：admin admin123
- TDengine：root taosdata
- SIP：12345678
- データソースモニタリング：fastbee fastbee
4. デプロイでよく使うコマンドリファレンス
# サービスのイメージを事前にプル可能。時間はネットワーク状況に依存。docker に国内ミラーソースを設定可能
docker-compose pull
# サービスのコンテナをビルドして起動
docker-compose up -d
# サービスのコンテナを停止して削除
docker-compose down
# data フォルダを作成
mkdir /var/data
# フォルダに読み書き実行権限を付与
sudo chmod 777 /var/data5. docker イメージ加速設定
以下の手順でコマンドを実行し、イメージ加速設定を完了します。docker イメージソースの加速アドレスはネットワークから収集したもので、状況に応じて追加・削除できます
# 1. Docker サービスを停止
sudo systemctl stop docker
# 2. ファイルが存在しない場合は新規作成
sudo mkdir -p /etc/docker
# 3. Docker の設定ファイルを変更
sudo tee /etc/docker/daemon.json <<-EOF
{
"registry-mirrors": [
"https://mirrors.ustc.edu.cn",
"https://docker.chenby.cn",
"http://mirror.azure.cn",
"https://dockerpull.org",
"https://dockerhub.icu",
"https://hub.rat.dev",
"https://dockerproxy.com",
"https://mirror.baidubce.com",
"https://docker.m.daocloud.io",
"https://docker.nju.edu.cn",
"https://docker.mirrors.sjtug.sjtu.edu.cn",
"https://docker.rainbond.cc",
"https://mirror.ccs.tencentyun.com",
"https://registry.docker-cn.com",
"https://hub-mirror.c.163.com",
"https://docker.1ms.run",
"https://doublezonline.cloud",
"https://dislabaiot.xyz",
"https://docker.fxxk.dedyn.io",
"https://docker.unsee.tech",
"https://docker.1panel.live",
"https://docker.nastool.de",
"https://docker.zhai.cm",
"https://docker.5z5f.com",
"https://a.ussh.net",
"https://docker.udayun.com",
"https://hub.geekery.cn",
"https://noohub.ru",
"https://huecker.io",
"https://dockerhub.timeweb.cloud",
"https://0c105db5188026850f80c001def654a0.mirror.swr.myhuaweicloud.com",
"https://5tqw56kt.mirror.aliyuncs.com",
"https://docker.ckyl.me/",
"https://docker.hpcloud.cloud"
]
}
EOF
# 5. Docker サービスを再起動
sudo systemctl daemon-reload
sudo systemctl start docker3. デプロイ結果の検証
デプロイ完了後、ページが開くかどうかだけを確認するのはお勧めしません。「コンテナ、バックエンド、データベース、キャッシュ、MQTT、業務ページ」の順で完全な検収を行うことをお勧めします。
1. コンテナの状態
cd /var/data
docker-compose ps
docker psすべてのコアコンテナが実行状態である必要があります。java、mysql、redis、emqx、nginx のコンテナが繰り返し再起動する場合は、まず対応するログを確認してください。
docker logs -n 200 java
docker logs -n 200 mysql
docker logs -n 200 redis
docker logs -n 200 emqx
docker logs -n 200 nginx2. バックエンドサービス
docker logs -n 300 java以下のエラーが継続して発生していないことを重点的に確認します：
- データベース接続失敗。
- Redis 認証失敗。
- ライセンス証明書の読み取り失敗。
- ポートの占有。
- SQL 初期化失敗。
- 時系列データベース接続失敗。
MySQL の初期化が遅い場合、バックエンドの初回起動が失敗したら 1〜2 分待ってから再起動できます：
docker restart java3. Web ページ
ブラウザでアクセス：
http://サーバーIP/デフォルトアカウント：
| ユーザー | パスワード |
|---|---|
admin | admin123 |
ログイン後、少なくとも以下のページを開いてインターフェースが利用可能かを確認します：
| ページ | 受け入れ条件 |
|---|---|
| ホーム | 統計カードとメニューが正常に読み込まれる |
| 製品管理 | リストが開き、新規追加ボタンが正常 |
| デバイス管理 | リストが開き、デバイス詳細の入口が正常 |
| システム管理 | ユーザー、ロール、メニューページが開ける |
| ライセンスページ | 商用版でライセンス情報をアップロードまたは確認できる |
4. MQTT サービス
EMQX コンソールアドレス：
http://サーバーIP:18083/デフォルトアカウント：
| ユーザー | パスワード |
|---|---|
admin | admin123 |
コンソールに入り、リスナーが正常であることを確認します。その後、製品からデバイスまでの完全なクローズドループ（中国語）に従って MQTTX で接続を確立できます。
5. 最小業務検証
デプロイ検収の最終基準はコンテナの実行ではなく、プラットフォームが実際の業務リンクを完了できることです：
- 製品を新規作成。
- モノモデルを定義。
- 製品を公開。
- デバイスを新規作成。
- MQTTX でプラットフォームに接続。
- 属性データを送信。
- プラットフォームから指令を送信。
完全な手順は 製品からデバイスまでの完全なクローズドループ（中国語）を参照してください。
4. docker チュートリアル
docker はオープンソースのアプリケーションコンテナエンジンで、開発者がアプリケーションと依存パッケージを軽量で移植可能なイメージにパッケージ化し、あらゆる一般的な Linux や Windows マシンに公開でき、仮想化も実現できます。コンテナは完全にサンドボックスメカニズムを使用し、相互にインターフェースを持ちません（iPhone のアプリに似ています）。さらに重要なのは、コンテナのパフォーマンスオーバーヘッドが非常に低いことです。
1. docker のインストール
提示
- docker イメージはデフォルトで公式リポジトリから取得します。ダウンロードが遅い場合は国内ミラーリポジトリに設定できます。参考チュートリアル（中国語）
- デスクトップ版をインストールすると、docker エンジンと docker compose がすでに含まれています。サーバーでは通常、docker engine と docker compose を個別にインストールします
Linux への docker インストール
Windows への docker デスクトップ版インストール
- 参考チュートリアル（中国語）（WSL サブシステムと Windows Terminal のインストールを推奨、その後 Docker をインストール）
- docker インストールチュートリアル
Mac への docker デスクトップ版インストール
2. docker 常用コマンド
docker -v # docker バージョンを確認、インストール成功かをチェック
docker ps # 実行中のコンテナを表示
docker ps -a # すべてのコンテナを表示
docker images # ローカルイメージを表示
docker info # docker のシステムレベル情報を表示
docker pull [image] # イメージをプル
docker run [image] # コンテナを実行
docker restart [container] # コンテナを再起動
docker stop [container] # コンテナを停止
docker stats [container] # コンテナのリソース使用状況を表示
docker inspect [container] # コンテナのメタデータを表示
docker logs -n 1000 [container] # コンテナの直近 1000 件のログを表示
docker exec -it [container] /bin/bash # 実行中のコンテナ内部に入る
docker save nginx:latest > nginx.tar # 単一イメージを保存
docker load -i nginx.tar # tar ファイルからイメージを読み込む
docker network create -d bridge fastbee-bridge # fastbee-bridge という名前の新しいネットワークを作成
docker network ls # すべてのネットワークを表示
docker network connect fastbee-bridge test # test コンテナをカスタムネットワークに参加
docker inspect fastbee-bridge # fastbee-bridge ネットワーク内のコンテナを表示3. docker ネットワークモード
docker には 5 種類のネットワークモードがあり、--net=*** でコンテナのネットワークモードを指定できます。
bridge モード # デフォルト。外部からコンテナ内のサービスにアクセスする場合、ホストの IP とホストのポート port にアクセスする必要がある
host モード # コンテナの IP アドレスがホストの IP アドレスとなる
container モード # コンテナは他のコンテナのネットワーク環境を共有する
overlay モード # ホスト間通信
none モード # コンテナにネットワーク環境を構築せず、127.0.0.1 のローカルネットワークのみ使用可能4. docker ブリッジ
ブリッジはコンテナ間の通信に使用します。各コンテナを個別に実行している場合は、以下のコマンドでブリッジを作成する必要があります
docker network create -d bridge fastbee-bridge5. docker-compose 常用コマンド
docker-compose -v # docker-compose バージョンを確認、インストール成功かをチェック
docker-compose up -d # サービスのコンテナをビルドして起動
docker-compose down # サービスのコンテナを停止して削除
docker-compose ps # サービス内のすべてのコンテナを一覧表示
docker-compose start # サービス内のコンテナを起動
docker-compose stop # サービス内の実行中のコンテナを停止
docker-compose restart # サービス内のコンテナを再起動
docker-compose logs # サービス内のコンテナの出力を表示
docker-compose pull # サービスが依存するイメージをプル
docker-compose config # compose ファイル設定を検証して表示5. 関連ドキュメント
- 製品からデバイスまでの完全なクローズドループ（中国語）
- 運用と保守（中国語）
- アップグレードガイド（中国語）
- マルチデータソースサポート（中国語）
- 時系列データベース（中国語）