ZenShellHub — 極簡単シングルファイルのシェルスクリプト管理センター

Web

概要

ZenShellHubは「极简、高颜值的单文件脚本管理中心」を目指すシンプルなPHP製アプリです。index.php一つで前端(React風UI)と後端(API・認証処理)を兼ね、データはJSONファイルで保持するためデータベース不要。初回アクセス時に管理者パスワードを設定し、未ログイン時は一覧やスクリプトが視覚的にぼかされ画像も読み込まれない実装でプライバシーを守ります。UIはiOSライクな毛ガラス(Backdrop Blur)と流れるアニメーションを採用し、運用や共有を直感的かつ美しく行える点が特徴です。導入はサーバーに配置するだけで動作する点が魅力です。

GitHub

リポジトリの統計情報

  • スター数: 16
  • フォーク数: 2
  • ウォッチャー数: 16
  • コミット数: 5
  • ファイル数: 4
  • メインの言語: PHP

主な特徴

  • 単一ファイル(index.php)でフロント+バックエンドを完結させるゼロ依存設計
  • iOSライクな毛ガラス(Backdrop Blur)UIとダークモード対応で視覚品質が高い
  • JSONファイルによる軽量な永続化と自動生成される.htaccessでデータ保護
  • 初回パスワード設定・未ログイン時のコンテンツ完全ぼかしなどプライバシー重視

技術的なポイント

ZenShellHubはindex.phpにReactライクなフロントエンドとPHPによるAPI処理を共存させるシングルファイルアプリケーションです。フロント側はモダンなDOM操作やCSS(backdrop-filter、アニメーション)でiOS風UIを実現し、未認証時はCSSと条件付きレンダリングでコンテンツや画像の読み込みを抑制して情報漏えいを防ぎます。サーバー側はPHPでルーティング(APIエンドポイント)、認証、JSONファイルのCRUDを実装しており、データは平文のJSONファイルに保存される設計です。安全対策として、初回アクセスでの管理者パスワード初期化、ログイン必須時の表示遮蔽、さらにデータディレクトリに対するダウンロード防止を目的とした.htaccess自動生成を行います。実運用で注意したい点はファイルベースの競合と整合性です。複数同時書き込みに対してはflock等のファイルロックや、一時ファイルへ書き込んでからリネームする原子操作を導入すると安全性が向上します。またスケールや検索機能の拡張が必要ならSQLiteなどの単一ファイルDB移行を検討すると良いでしょう。セキュリティ面ではHTTPS運用、適切なファイル権限、セッション管理(セッション固定化対策、CSRFトークン)、入力検証とサニタイズが重要です。単純で可搬性の高い設計は開発・運用の敷居を下げますが、大規模共有や高トラフィック環境では構成見直しが必要になります。

プロジェクトの構成

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

  • .gitattributes: file
  • LICENSE: file
  • README.md: file
  • index.php: file

まとめ

単一ファイルで即導入できる美しいシェル管理UI。小規模運用に最適。

リポジトリ情報:

READMEの抜粋:

ZenShellHub 🐚

极简、高颜值的单文件脚本管理中心。

ZenShellHub 是一个单文件(Single-File)的 PHP 应用程序,旨在帮助运维人员、开发者以最优雅的方式管理和分享常用的 Shell 脚本命令。它不需要数据库,不需要复杂的安装过程,上传即用。

设计上采用了 “Zen-iOS Hybrid” 视觉语言,拥有极致的物理触感、光学模糊效果和流畅的交互动画。

✨ 核心特性

  • 💎 极致 UI 设计 :全站采用 iOS 级毛玻璃(Backdrop Blur)效果,物理光学边框,深色模式适配。
  • 🚀 零依赖单文件 :所有逻辑(前端 React + 后端 PHP)集成在唯一的 index.php 中。
  • 🔒 安全隐私
    • 首次访问强制初始化管理员密码。
    • 未登录状态下内容完全模糊遮挡,甚至不加载图片资源。
    • 自动生成 .htaccess 防止数据文件被外部下载。
  • ☁️ 数据持久化 :使用 JSON 文件存储,无需 MySQL/Redis,迁移只需…