Shirushi（しるし）

個人用のブックマーク管理アプリです。URLを保存・タグ管理・検索するだけでなく、 検索 → 複数選択 → バルクタグ付けという流れで関心の記録を育てることを重視しています。

Go + SQLite のシングルバイナリで動き、自宅サーバー（Proxmox / Alpine Linux）に置いて Caddy 経由で外出先からも使えます。

インスピレーション: Shiori をベースに、 アーカイブや複数ユーザー管理は省き、バルク操作・タグ管理・個人の研究記録に特化して作り直しました。

---

機能

• ブックマークの追加・編集・削除
• OGP メタデータ（タイトル・説明・サムネイル）の自動取得
• タグの作成・編集・削除、ブックマークへの紐付け
• キーワード検索・タグフィルター・日付検索（202507 で2025年7月など）
• チェックボックスで複数選択 → バルクタグ追加・削除・一括削除
• Netscape Bookmark 形式（Chrome/Firefox のエクスポート形式）でインポート・エクスポート
• パスワード認証（シングルユーザー）
• ダークテーマ固定

---

ビルド

# 手元の環境で実行する場合
go build -o shirushi .

# Alpine Linux / Proxmox LXC 向け静的バイナリ（CGO 不要）
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o shirushi .

Go 1.22 以上が必要です。依存ライブラリは modernc.org/sqlite（CGO 不要の純粋 Go 実装）のみです。

---

起動

SHIRUSHI_PASSWORD='yourpassword' ./shirushi

ブラウザで http://localhost:8181 を開いてください。

SHIRUSHI_PASSWORD が未設定の場合は起動時にエラーになります。

---

環境変数

変数名	デフォルト	説明
SHIRUSHI_PASSWORD	（必須）	ログインパスワード。未設定だと起動しません
SHIRUSHI_ADDR	:8181	待ち受けアドレス。Caddy 同一ホスト構成では 127.0.0.1:8181 を推奨
SHIRUSHI_COOKIE_SECURE	（未設定）	1 にするとセッション Cookie に Secure 属性を付与。HTTPS 運用時に設定
SHIRUSHI_ALLOW_PRIVATE_FETCH	（未設定）	1 にするとメタデータ取得時の SSRF チェックを無効化。社内ツールなど限定用途向け

---

Caddy を使った HTTPS 運用

Caddy を別の LXC コンテナで動かし、Shirushi を別の LXC コンテナに置く構成を想定しています。

インターネット
  → Caddy LXC（HTTPS 終端）
  → Proxmox ブリッジ
  → Shirushi LXC（:8181）

Caddyfile（Caddy LXC 側）:

shirushi.example.com {
    reverse_proxy <Shirushi LXC の LAN IP>:8181
}

Shirushi の起動（Shirushi LXC 側）:

SHIRUSHI_PASSWORD='長くランダムなパスワード' \
SHIRUSHI_COOKIE_SECURE=1 \
./shirushi

待ち受けアドレスはデフォルトの :8181（全インターフェース）のままで構いません。 80/443 番ポートのみ外部公開し Caddy にルーティングする構成であれば、8181 はインターネットに露出しません。

注意: header_up -X-Forwarded-For で XFF ヘッダーを削除しないでください。 XFF がない状態で全リクエストが Caddy LXC の IP として扱われ、ログイン失敗カウントを 全クライアントで共有します。Caddy の reverse_proxy はデフォルトで XFF を自動付与するため、 通常は設定不要です。

---

バックアップとリストア

データベースは実行ファイルと同じディレクトリの shirushi.db に保存されます。

# バックアップ（サーバー停止不要。WAL モードのため安全にコピーできます）
cp shirushi.db shirushi.db.backup-$(date +%Y%m%d)

# リストア
cp shirushi.db.backup-20260614 shirushi.db

WAL モードでは shirushi.db-wal と shirushi.db-shm という補助ファイルも作られます。 バックアップ時はこれらもあわせてコピーするか、VACUUM コマンドで統合してからコピーしてください。

# WAL を統合してからバックアップ（よりシンプル）
sqlite3 shirushi.db "VACUUM;"
cp shirushi.db shirushi.db.backup-$(date +%Y%m%d)

---

テスト

go test -v -cover ./...

---

既知の制限

• シングルユーザーのみ: 複数アカウントには対応していません
• セッションはメモリ管理: サーバーを再起動するとログアウト状態になります
• インポート時のサムネイル未取得: Netscape Bookmark 形式でインポートした場合、OG 画像は取得されません（追加後に個別編集で取得できます）
• アーカイブ機能なし: ページのオフラインコピーは作成しません

---

API

エンドポイント・リクエスト・レスポンス・エラーコードの詳細は docs/api.md を参照してください。

---

ライセンス

MIT