Unofficial
このページの内容
  1. 01始める前に
  2. 02プロジェクトを作成する
  3. 03プッシュのたびに公開する
  4. 04他の NAS にリポジトリを追加する
  5. 05Cloudflare Tunnel でインターネット越しに使う
  6. 06インターネットから到達できるもの

独自の App Center:Git から全 NAS へ QPKG パッケージを配布

Bucket & Code Server IDE は NAS 上に App Center リポジトリを保持します。新しいプロジェクト で作成した QPKG プロジェクトは、Git にプッシュするたびにビルドされ、パッケージをそのリポジトリに公開します。他の NAS は、リポジトリのアドレスを App Center に一度追加するだけで、他のアプリと同じようにパッケージをインストールおよび更新できます。Cloudflare Tunnel を使えば、ルーターのポートを開けずにリポジトリ(希望すれば Git も)をインターネットに公開できます。

  1. 準備モジュール、QDK、証明書
  2. プロジェクト新しいプロジェクト、QPKG パッケージ
  3. リポジトリApp Center でのアドレス
  4. インターネットパッケージ用のホスト名

画像はパネルのもので、各項目は本ガイドの説明どおりに入力しています。アドレスは 192.168.1.20 の NAS のもので、公開する名前には、example.com 配下の例を使っています。

01始める前に

  • Git、CI、エディターがオンになっている必要があります。オンにするのは管理者で、概要 にあるそれぞれのボタン(「Git」をオンにする、「Git」と「CI」をオンにする、「エディター」をオンにする)を使います。新しいプロジェクトのウィザードには Git とエディターが必要で、CI はプッシュのたびにプロジェクトのワークフローを実行します。
  • QDK がインストールされている必要があります。ツールチェーン ページの QNAP タブで QNAP QDK 2.5.0 をインストールしてください。
  • 認証局から購入した、または QNAP が発行したコード署名証明書が、ファイルの形か USB トークン上の鍵で必要です。ファイルの名前は certificate、private_key、チェーン用の ca_certs です。

02プロジェクトを作成する

Git ページまたはコマンドパレットから 新しいプロジェクト を開きます(開発者ロールが必要です)。

  1. テンプレート。 QTS 用パッケージ の下で QPKG パッケージ を選び、次へ を押します。 QTS 用パッケージ:QPKG パッケージを選択、その横に App Builder のアプリ
  2. 名前と公開範囲。 この名前はリポジトリ、フォルダー、パッケージの名前になります。使えるのは 1〜20 文字の英字、数字、ハイフン、アンダースコアです。所有者はご自身のアカウントまたは組織にします。プロジェクトは 非公開 のままにします。 Name nas-notes, Owner ola, Visibility Private
  3. サービス。パッケージの起動と停止の方法を選びます。コマンドラインツール はプログラムを /usr/bin にリンクします。バックグラウンドサービス は専用のアカウントでプログラムを実行します。Web アプリ では、さらに App Center の「開く」ボタンが付きます。空 ではサービススクリプトが作られますが、起動、停止などのコマンドにはまだブロックがありません。これらのブロックは、後からプロジェクトビューで変更できます。 Start from: Command-line tool chosen; Background service, Web app and Empty
  4. ビルド。 プロジェクトをビルドする環境を選び、作成後すぐにビルド はオンのままにします。 ビルド環境:ubuntu2404-builder、ubuntu-24.04-x86_64、glibc 2.39、そしてビルドは bvs-chroot を通じてこの環境内で実行されるという注記 作成後すぐにビルド、オン
  5. 公開。 この NAS の App Center リポジトリに公開 をオンにします。同じスイッチがその後もプロジェクトの設定に残り、CI が実行のたびに公開できるようになります。 公開:この NAS でテストデプロイ はオフ、署名済みパッケージのみ;この NAS の App Center リポジトリに公開 はオン;自分の Web サーバーに公開 はオフ
  6. 確認。 実行される手順を確認し、プロジェクトを作成 を押します。 実行される内容:Forgejo のリポジトリと最初のコミット、最初のビルド、App Center リポジトリに公開;テストデプロイと自分の Web サーバーに公開 は未選択;「プロジェクトを作成」ボタン

最初のジョブは、Forgejo にリポジトリを作成し、projects/<name> フォルダーを作って、最初のコミットを行います。コミットに含まれるのは、テンプレートのファイルと、ワークフロー .forgejo/workflows/build.yml です。

03プッシュのたびに公開

リポジトリへのプッシュのたびに、NAS 自身のランナーでワークフローが実行されます。ワークフローはパッケージをビルドし、--latest 付きで公開します。そのため、repo.xml にはすぐに新しいバージョンが載り、App Center は次回の確認時にそれを提供します。

プロジェクトのページ(プロジェクト、またはエディタのサイドバー)では、同じ手順を手動で実行できます: ビルド、再ビルド、テストデプロイ(管理者のみ)、公開。

QPKG プロジェクトのパイプライン: ubuntu2404-builder でのビルド(ビルドと再ビルド)。テストデプロイにはコード署名済みのパッケージが必要。公開には、ビルドが署名なしで、リポジトリは署名済みパッケージのみ受け付けること、CI も App Center リポジトリに公開することが表示される。Web に公開 はここでは実行できない

その 設定 カードに、スイッチ App Center リポジトリに公開 があります。スイッチがオフの間、CI は公開を行わず、そのことを通知します。

App Center リポジトリに公開 をオンにした状態: このプロジェクトの CI が、パッケージをこの NAS の App Center リポジトリに追加します

パッケージ ページには、すべてのパッケージが最新バージョンと署名の状態とともに一覧表示されます。開発者が手動でアップロードしたバージョンは、管理者が最新のバージョンに指定するまで待機します。

公開済みパッケージ: 名前、最新バージョン、アーキテクチャ、署名の有無、バージョン、公開日時

04他の NAS にリポジトリを追加する

  1. パッケージ ページの App Center 用アドレス カードからアドレスをコピーします。 App Center 用アドレス: http://192.168.1.20:9950/repo/repo.xml
  2. 他の NAS で、App Center → ⚙ Settings → App Repository → 追加 の順に進みます。名前を付け、アドレスを貼り付けて 追加 を押します。
  3. パッケージは、App Center の左側のリストでその名前の下に表示されます。そこからインストールしてください。リポジトリに新しいバージョンが載ると、App Center はそれをアップデートとして提案します。

この LAN アドレスは、同じネットワーク内の NAS で使えます。ネットワークの外にある NAS では、リポジトリをインターネットに公開してください。

05Cloudflare Tunnel でインターネット経由で公開

このパッケージには cloudflared が同梱されており、NAS から Cloudflare へ外向きに接続します。ルーターのポートは開放されず、名前の証明書は Cloudflare が管理します。DNS が Cloudflare にあるドメインと、そのゾーン用の API トークン(dash.cloudflare.com の My Profile → API Tokens)が必要です。トークンには次の 4 つの権限が必要です: Account, Cloudflare Tunnel, Edit、Zone, DNS, Edit、Zone, Cache Rules, Edit、Zone, Cache Purge, Purge。トークンで Client IP Address Filtering を使っている場合は、NAS の公開アドレスを IPv4 と IPv6 の両方とも登録してください。

名前提供する内容
パッケージ用のホスト名
qpkg.example.com
/repo/ への GET と HEAD のみ。他の NAS の App Center にはこれだけで十分です
メインのホスト名
code.example.com
パネル、/git/ の Forgejo(HTTPS でのクローンとプッシュ用)、パッケージリポジトリ(読み取り専用)、公開リポジトリの Web 表示、ユーザーガイド
  1. メインのホスト名を公開する場合は、まず Git ページの 公開閲覧 をオンにし、保存して Forgejo を再起動 を押します。オフのままだと、公開ページはメインのホスト名を受け付けません。非公開のリポジトリは表示されません。 Git ページでオンになっている「公開閲覧」スイッチ
  2. 管理者のみ: 管理メニューの 公開 を開きます。名前とトークンを入力し、キャッシュのプリセット をオンのままにして 公開 を押してください。パッケージはまず Cloudflare 側ですべてを確認し、確認に失敗した場合は Cloudflare 側を変更せず、何を直すべきかを示します。 ホスト名とトークン: メインのホスト名 code.example.com、パッケージ用のホスト名 qpkg.example.com、トークンは伏せ字、トンネル名は空欄、キャッシュのプリセットはオン、トークンに必要な 4 つの権限と「公開」ボタン
  3. 次に、パッケージがトンネルを作成し、各名前をそのトンネルに向けて、cloudflared を起動します。トンネル カードに接続状態が表示されます。 トンネル カード: Cloudflare への接続が4つ、cloudflared は実行中、トンネル名 bucketvs-nas-lab、公開名 code.example.com と qpkg.example.com
  4. パッケージ ページの App Center 用アドレスは、これでパッケージ用のホスト名を指すようになります。ネットワーク外の NAS では、このアドレスを追加してください。 App Center 用アドレス: https://qpkg.example.com/repo/repo.xml
  5. メインのホスト名を使う場合は、ネットワーク ページの 公開 URL をそのアドレスに設定します。こうすると、Forgejo のリンクと HTTPS のクローンアドレスがそのアドレスを使うようになります。 ネットワークページで公開 URL が https://code.example.com に設定されている
  • Git over SSH はトンネルを通りません。外からは HTTPS でクローンとプッシュするか、ルーターのポートを Git over SSH のポート(9952)に転送し、ネットワーク ページで クローン URL の SSH ホスト を設定してください。
  • Cloudflare は 100 MB までのリクエストを受け付けます。それより大きいものは、LAN アドレス経由でプッシュまたはアップロードしてください。
  • リポジトリへの公開のたびに、repo.xml は Cloudflare のキャッシュからすぐに消去されるので、App Center は次回の確認時に新しいバージョンを認識します。

06インターネットから到達できるもの

公開ページには、各名前が提供する内容と、その横にあるキャッシュルールが一覧表示されます。

インターネットから到達できるもの: メインのホスト名は、パネル、Forgejo、Web 表示、パッケージリポジトリを提供します。エディターはスイッチがオンの間だけ提供し、WebDAV は決して提供しません。パッケージ用のホスト名は /repo/ への GET と HEAD のみを提供します。キャッシュプリセット: パッケージは 1 年、アイコンは 1 日、repo.xml は 5 分で、公開のたびに消去されます。API、Forgejo、サインインは決してキャッシュされません
  • メインのホスト名は、管理者が エディターを公開 をオンにするまで、/ide/ に 404 を返します。エディターのターミナルは NAS 上の root シェルなので、先に開発者と管理者のアカウントで 2 要素認証を有効にしてください。 インターネット上のエディター: 「エディターを公開」スイッチはオフで、root シェルと 2 要素認証の警告が表示される
  • CI がオンの間は、どのリポジトリにプッシュされたワークフローも、NAS 上で root として実行されます。インターネットからのプッシュでも LAN からのプッシュでも同じです。プッシュ権限は、NAS の管理者パスワードを渡してもよい相手にだけ与えてください。
  • 公開した名前を通して、最初の管理者パスワードを設定することはできません。最初の設定画面は、ローカルネットワーク上のクライアントからしか受け付けないためです。
  • 停止 は cloudflared を終了させ、Cloudflare 側は何も変更しません。Cloudflare から削除 は、パッケージが作成した DNS レコード、キャッシュルール、トンネルを削除し、保存したトークンも消去します。