Bucket & Code Server IDE
QNAP サーバーのための工房。
Bucket & Code Server IDE は、QNAP NAS のための開発工房です。Forgejo による Git、CI、バージョン管理された Bucket、ブラウザーの VS Code、そしてレシピを QPKG にコンパイルする App Builder。ほかのアプリと同じく App Center からインストールできます。
Bucket & Code Server IDE は、すでにお持ちの QNAP NAS に、専用の Web サーバー、専用のアカウント、専用のツールを備えた完全な開発環境をインストールし、すべてをボリューム上の 1 つのデータフォルダーにまとめます。ブラウザーでコードを書き、Forgejo にプッシュし、NAS 上のランナーにビルドさせ、自分の App Center リポジトリに公開します。これらすべてを操作するパネルはコードエディターのように使え、9 つの言語に対応しています。
01 · ワークベンチ
アクティビティバー、サイドバー、タブ、コマンドパレット、下部パネル、ステータスバー。VS Code を使い慣れていれば、迷うことはありません。各ページはタブで開き、Ctrl+Shift+P でロールが実行できるすべてのコマンドを呼び出せます。ステータスバーには、モジュールの動作状況、ボリュームの残り容量、証明書の状態が表示されます。
02 · 新しいプロジェクト
テンプレートを選び、名前を付けて、プロジェクトを作成 を押します。1 つのジョブが Forgejo リポジトリを作成し、CI ワークフロー付きのテンプレートをコミットしてプッシュし、エディターが開くフォルダーにコピーを置きます。CI がオンなら、次のプッシュが NAS 上でビルドされます。
main 上にあり、公開を選ばない限り非公開です03 · Git
Forgejo は、リポジトリ、Issue、プルリクエスト、リリース、Wiki、LFS、ミラー、Webhook を、あなた自身のディスク上で提供します。パネルのアカウントはすべて Forgejo のアカウントでもあるので、2 つ目のユーザー一覧を同期させる必要はありません。HTTPS 経由の git はパネルのパスワードを受け付け、2 要素認証がオンならアクセストークンを受け付けます。
04 · CI
ワークフローをプッシュすると、NAS 上の Forgejo Actions ランナーがそれを受け取ります。ジョブは NAS そのものの上で動き、パッケージのツールとあなたのビルド環境をすぐに使えます。
runs-on: bucketvs、またはラベル qnap-x86_64、qnap-aarch64、self-hostedbvs env run を使えば、どのジョブからでも自分の環境の中でビルドできます05 · エディター
開発者ごとに、ブラウザーで使う自分専用の VS Code（code-server）があります。そのターミナルでは git、svn、node、npm、rsync、curl にパスが通っていて、コマンド 1 つで完全な Linux 環境に入れます。エディター設定ページから Claude Code、Gemini CLI、Codex CLI をインストールでき、ウィザードが作るプロジェクトには、QNAP NAS がシェルでどう動くかを AI アシスタントに教えるスキルが入っています。
06 · SVN と Bucket
Bucket は、保存したファイルがそのたびにリビジョンになるネットワークドライブです。以前のどのバージョンでも開き、別のバージョンと比べ、新しいリビジョンとして戻せるので、何も失われません。Subversion のリポジトリも Bucket のすぐ隣にあり、同じアカウントで使えます。
._* と .DS_Store ファイルは、既定で履歴に入りません07 · ツールチェーン
Debian、Ubuntu、Alpine を NAS 上の環境に展開し、普通の Linux マシンと同じように作業できます。Debian と Ubuntu では apt install が使え、インストールしたものは残ります。必要なランタイムとコンパイラーは署名付きのカタログから追加でき、ダウンロードしたものはすべて、使う前に sha256 で検証されます。
qpkg.cfg のある任意のフォルダーから QPKG をビルドする bvs qbuild08 · App Builder
523 のレシピからプログラムを選び、リンクのしかたを決めてビルドします。App Builder はすべてを環境内の 1 つのフォルダーにコンパイルし、ビルドが前回のものを置き換える前に、すべてのプログラムを検査します。アプリを有効化すればそのプログラムが NAS 上で動き、独立した QPKG としてエクスポートすることもできます。
09 · 依存関係
「Library not found」は、NAS の上で驚くことではなくなるべきです。依存関係タブは、ビルドのすべての ELF ファイルを実行せずに読み、それぞれが何を必要とし、NAS のローダーがそれをどこで見つけるかを示します。見つからないライブラリ、ライブラリが定義していないバージョン、アプリの外を指す RUNPATH は、修正方法付きの検出結果になります。
bvs ldd と bvs deps で、シェルからも同じ答えが得られます10 · カーネル
QNAP が提供していないドライバーが必要ですか。カーネル工房は、実行中のカーネルが自分自身について示す情報を読み、それに合うカーネルツリーを用意して、そのツリーに対してモジュールをビルドします。すべてのモジュールは読み込む前に実行中のカーネルと照合され、照合に通らないモジュールは決して読み込まれません。
struct module のレイアウト11 · パッケージ
QPKG をパッケージの App Center リポジトリに公開し、ほかの NAS の App Center にそのアドレスを追加すれば、ほかのリポジトリと同じようにインストールできます。App Center にどのバージョンを見せるかは、あなたが決めます。
bvs repo publish でアップロード12 · 公開
公開ページは、パネル、Forgejo、パッケージリポジトリを、DNS が Cloudflare にある自分のドメインの名前で公開します。cloudflared が NAS から外へ接続するので、ルーターのポートは開けず、証明書は Cloudflare が持ちます。どのリクエストも引き続きパッケージ自身の認証を通り、アカウントなしで開けるのは、あなたが公開したものだけです。
13 · バックアップ
Git、SVN、Bucket、設定、VS Code の設定の毎日のバックアップは、直近 7 日、4 週、6 か月分を保持します。コピーの送り先は NAS 上のフォルダー、rsync と SSH、または rclone が届くあらゆる場所で、NAS の外に出るコピーはすべて age で暗号化されます。
svnadmin verify、git fsck14 · 例
例のギャラリーには、ワンクリックで適用できる 63 の例があります。そのうちいくつかは完全な製品です。TurboDNS は PowerDNS Authoritative Server 5.1.4 をレシピからビルドし、ゾーンパネルを加えて、両方を CI ワークフロー付きの QPKG にまとめます。MailServerPro は同じことを Postfix、Dovecot、Rspamd、Roundcube で、WebHostPro は nginx、Apache httpd、PHP、データベースで行います。
ソースからビルドするメールサーバー。SMTP には Postfix、IMAP、POP3、Sieve、ManageSieve には Dovecot と Pigeonhole、スパム対策には Rspamd と Valkey、ClamAV、パスワードの総当たり対策には fail2ban。DKIM 署名、SPF、DMARC、ARC、グレイリスティング、MTA-STS、そして独自の検証リゾルバーによる DANE。Web メールには Roundcube、カレンダーと連絡先には CalDAV と CardDAV、Exchange ActiveSync には Z-Push。複数のドメイン、容量制限付きのメールボックス、エイリアス、キャッチオール、転送、不在時の自動応答を 1 つのデータベースで管理します。管理パネルでは、ドメイン、メールボックス、DKIM 鍵を追加し、各ドメインに必要な DNS レコードを一覧し、キューとログを表示し、すべてのメールボックスをバックアップします。App Builder がそのレシピを NAS 上でコンパイルし、make ターゲット 1 つでアプリがQPKG になります。
WebHostPro（Web サーバー）、TurboDNS（DNS サーバー）、MailServerPro（メールサーバー）は、例のギャラリーにあるエディター用プロジェクトです。それぞれ専用のパネルを備え、QPKG としてパッケージ化されています。
パネルは実物で、ビルド用マシンのブラウザーで開いたものです。データは作り物です：example.org と example.test 配下の名前、ドキュメント用の範囲のアドレス、ローカルのアドレス。
Bucket & Code Server IDE をインストールし、サインインして、必要なモジュールをオンにします。
QNAP is a trademark of QNAP Systems, Inc. Bucket & Code Server IDE is made for QNAP NAS; it is not made or endorsed by QNAP.