Posts on furu04

GDGoCのハッカソンで在庫管理×家計簿アプリ「俺金欠」を作った話

Mon, 23 Mar 2026 11:00:00 +0900

はじめに

2026年3月、GDG on Campus（Google Developer Group on Campus）のハッカソンに参加しました。

チーム3人で約1週間、在庫管理×家計簿Webアプリ 「俺金欠」 を開発した記録です。

リンク

どんなアプリを作ったか

「また同じもの買ってきちゃった…」

家族や同居人と暮らしていると、誰もが経験するこの問題。

冷蔵庫にもう牛乳があるのに買ってきてしまう。

洗剤がまだあるのに「なくなりそうだった気がする」で2本目を買ってしまう。

俺金欠は、グループ内で購入した商品・在庫をリアルタイムに共有し、二重買いをなくすことを目指した在庫管理×家計簿アプリです。

主な機能

グループ在庫管理: 冷蔵庫・パントリー・洗面所など保管場所ごとに在庫を整理・共有
AI自動タグ付け（Gemini搭載）: 商品画像やテキストからAIが検索用タグを自動生成、カテゴリも提案
家計簿機能: 購入記録から月次支出を自動集計、カテゴリ別・メンバー別の支出をグラフで可視化
在庫アラート: 残量が少ない商品を検出し、買い忘れを防止
招待コードによるグループ管理: 承認制メンバー管理でセキュアに運用

チーム体制

メンバー	担当
バックエンド担当 (私)	API設計・DB設計・インフラ・AI連携・Docker運用
フロントエンド担当 ×2	React + TypeScript によるSPA開発・UI/UXデザイン

計 3名。バックエンド1人、フロントエンド2人という構成でした。

しかし終盤になって フロント・バック間でAPIエンドポイントの認識がずれており その修正でバックの私もフロントエンドにかなり手を加えました。

技術スタック

レイヤー	選定技術
フロントエンド	React 19 + TypeScript 5.9 + Vite 6 + MUI 7 + Tailwind CSS 4
バックエンド	Go 1.25 + Gin + GORM
データベース	MySQL 8.0（本番）/ SQLite（開発）
AI	Google Gemini API
セキュリティ	JWT認証 + Cloudflare Turnstile
インフラ	Docker on LXD、running on GCE

GDGのイベントということもあり、Googleエコシステムの活用が推奨されていた ためAIには Google Gemini を採用し、インフラには Google CloudのVM であるGCEを利用しました。

Super Homework ManagerをDockerで動かす

Sun, 11 Jan 2026 15:08:34 +0900

この記事では、Docker と Docker Compose を使って Super Homework Manager を本番環境にデプロイする方法を初心者向けに解説します。

Super Homework Manager とは

Super Homework Managerは私が開発した課題管理Webアプリです。

課題の重要度に応じて鬼のような督促を行う機能などを設けており（！）提出物を遅れがちな学生、遅れたくない学生にとっておきのアプリとなっています。

詳細についてはこちらのGitリポジトリをご覧ください。

必要なもの

サーバー: VPSまたは自宅サーバー（Debian13推奨）
- 本WebアプリはRAM1GB/CPU1コア/ディスク10GBもあれば十分動作します。
- 海外の格安VPSなら年10ドル程度で入手可能です。
- とにかく予算を抑えたいならRackNerdのRAM1GBプランがおすすめですが、今後色んなものを動かしたい場合はスペックもよく大手のOVH VPSがおすすめです。
ドメイン: 独自ドメインが必要です。ない場合Cloudflare Registrarで取得するのがおすすめです。
- それでも予算がない場合GitHub Student Developer Packで.meドメインが1年無料なのでご自身で確認してください。

事前準備

1. Dockerのインストール

サーバーにSSHで接続し、以下のコマンドを実行します。

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER

インストールが完了したら、一度ログアウトして再度ログインしてください。

2. インストールの確認

docker --version
docker compose version

上記コマンドでDockerとDocker Composeのバージョンが表示されれば成功です。

設定ファイルの準備

1. リポジトリのクローン

git clone https://git.watanabebashi.net/furu04/Super-HomeworkManager
cd Super-HomeworkManager

以上のコマンドで私のGitサービスからリポジトリをクローンし、ディレクトリに移動します。

2. Telegram Botの作成（任意）

本アプリには課題作成時や期限が近づいた時のリマインダーをTelegram~~/LINE~~で受け取る機能があります。

任意ではありますが大変便利なので作成することをおすすめします。

本記事では簡単に作成できるTelegram Botの方で進めていきます。

2026年の目標

Sat, 27 Dec 2025 10:03:05 +0900

あと数日で今年が終わるという事で2026年の目標を立てておきます。

プログラミングのスキルを上げる
新しい技術スタックを学ぶ
個人プロジェクトに取り組む時間を増やす
ポートフォリオを可視化させる
資格取得

最近はブログにいいね・コメントボタンを実装できる高機能APIサーバ「WB-Likomment」というのを絶賛開発中なのでこれをはよ完成させて実装させたいですね。

あとはDockerを使ってみたいなと思います。当サイトや当方のサービスはLXDで運用しているのですが、CI/CDとか全然やったことないのでひとまずWB-Likommentで試してみます。

資格がらみは今年はネスぺ受験予定なのでまずはそれを目指していきたいです。加えてAWS SAAも取得したいなーと思っています。2月15日まで25%割引なので早めに取り組んでいこうと思っています。

あとは長期休みをだらだらしがちなので対策をしたいですね。

自分はStructuredというアプリを使ってタイムボクシングをしているのですが、タイムボクシングすらさぼっちゃう事があるのでそこをどうにかという感じです。

LXDコンテナをホスト間で移行する方法

Sat, 29 Nov 2025 19:35:00 +0900

Watanabebashi.netや私が自鯖で運用しているインフラは基本的にLXDコンテナで運用しているのですが、今回新サーバに移行するためLXDコンテナをホスト間に移行する方法をまとめます。

私の環境

移行元ホストと移行先ホストの両方にLXDをインストール済み
両ホストともLXDのストレージプールはdir
移行前と移行後のLXDのバージョンは同じ(v5.0.2)

移行先ホストの初期設定

移行先ホストでLXDの初期設定をします。

基本的にストレージプールとバージョンが同じだと大きな問題は起こらないのですが、コンテナに固定IP設定をしていたり、コンテナ間の通信でLXDホスト名(コンテナ名.lxd)ではなく、固定IPで通信している場合は、移行先ホストで同じサブネットマスクを設定し、同じIPアドレスが割り当てられるようにしておく必要があります。

上記のケースに該当しないと思っていても気づかずにそういった設定をしている場合もあるので、念のため以下のコマンドで移行すべきでしょう。

まず移行元ホストで以下のコマンドを実行し、LXDのブリッジネットワーク設定を確認します。

lxc network show lxdbr0

すると以下のような出力が得られます。

config:
  ipv4.address: [自分のアドレス]
  ipv4.firewall: "false"
  ipv4.nat: "true"
  ipv6.address: [自分のアドレス]
  ipv6.firewall: "false"
  ipv6.nat: "true"
...

上記のipv4.addressとipv6.addressの値をメモしておき、移行先ホストでlxd initを実行する際に同じ値を設定します。

これでひとまずコンテナを移行する前の準備は完了しました。

コンテナの移行

コンテナを移行するには、移行先ホストで以下のコマンドでパスワードを設定します。推測されにくいパスワードを設定してください。

lxc config set core.trust_password <パスワード>

次に、通信に必要な8443ポートを空けます。

クラスタリング等で利用している場合を除き、8443ポートは移行元ホスト以外がアクセスする必要はないためファイアウォールで移行元ホストからのアクセスのみ許可する設定にしてください。

例としてUFWでデフォルトはポートを閉じている場合以下のコマンドを実行します。

sudo ufw allow from <移行元ホストのIP> to any port 8443 proto tcp

その後、移行先ホストで以下のコマンドを実行し、LXDが外部からの接続を受け付けるようにします。

lxc config set core.https_address "[::]:8443"

そこから移行元ホストで以下のコマンドを実行し、移行先ホストをリモートとして登録します。

lxc remote add <任意の名前> <移行先ホストのIP>

その後通信に成功すると以下のような表示が出ます。

Generating a client certificate. This may take a minute...
Certificate fingerprint:<フィンガープリント>
ok (y/n/[fingerprint])?

ここで移行先ホストのフィンガープリントが正しいか確認を求められるので、移行先ホストで以下のコマンドを実行し、フィンガープリントが一致していれば「y」と入力します。

ColoCrossingの専用サーバに移行した

Tue, 25 Nov 2025 19:30:00 +0900

今回、私が利用しているサーバをColoCrossingという所の専用サーバに移行しました。以下に詳細を記します。

ColoCrossingとは

ColoCrossingはアメリカのホスティング業者です。コロケーション・専用サーバ・VPSを提供しています。

米国内ではニューヨーク・シカゴ・ロサンゼルスなど合計8か所にリージョンがあるほかダブリンやトロントにもデータセンタを構えているそうです。創業は2006年となかなかの老舗です。

2023年ごろまで主に大口向けにサービスを提供しており、海外の格安VPSは同社のコロケーションを利用していたりリセラーであることが多々ありましたが、同年から自社でのVPSの提供などリテール事業を強化しているようです。

契約したサーバ

今回契約したのは以下のスペックのサーバです。

CPU: Intel Xeon E3-1270
RAM: 32GB
ストレージ: 1TB SSD
帯域幅: 10TB@1Gbps
/30 IPv4
ロケーション: ニューヨーク・バッファロー
料金: 年払いで119.04ドル

このスペックで月額約10ドルって採算取れてるの？と心配になるレベルの安さです。1Uサーバだし電気代だけでも相当するんじゃ…

届いたら実際にはCPUはE3-1270v2でした。やったね！

掲示板を見ると同社は場合によっては勝手にスペックをアップグレードしてくれる場合があるとのこと。1TBのストレージがついてくるはずが実際には1TB*4になっていた人もいるらしいです！

支払い方法にはクレジットカード、PayPal、Alipay、仮想通貨払いがあり、私はクレジットカードで支払いました。

ところで、同社は海外の会社ですし、ドル建て決済なので国内のたいていのクレジット会社では海外事務手数料がかかります。

昨今この手数料率を値上げするカード会社が増えている(参考)ので、海外サーバやクラウドを使うことが多い人はRevolutなど海外事務手数料が無料のカードの利用を検討してもいいでしょう。

たかが3.5%前後と言っても年数万円払うなら数百円かかります。手数料でコーラでも飲む方が有意義でしょう。

セットアップ

セットアップは、サーバの契約時にOSを選択するかIPMIで自分でインストールするかの2通りがあります。私はフルディスク暗号化したい都合上、自分でインストールする方法を選びました。

ベンチマーク

UnixBenchの結果は以下の通りでした。

UnixBenchの結果

BYTE UNIX Benchmarks (Version 6.0.0)

System: [REDACTED]: GNU/Linux
OS: GNU/Linux -- 6.12.57+deb13-amd64 -- #1 SMP PREEMPT_DYNAMIC Debian 6.12.57-1 (2025-11-05)
Machine: x86_64 (unknown)
Language: en_US.utf8 (charmap="ANSI_X3.4-1968", collate="ANSI_X3.4-1968")
CPU 0: Intel(R) Xeon(R) CPU E3-1270 V2 @ 3.50GHz (6999.9 bogomips)
                        Hyper-Threading, x86-64, MMX, Physical Address Ext, SYSENTER/SYSEXIT, SYSCALL/SYSRET, Intel virtualization
CPU 1: Intel(R) Xeon(R) CPU E3-1270 V2 @ 3.50GHz (6999.9 bogomips)
                        Hyper-Threading, x86-64, MMX, Physical Address Ext, SYSENTER/SYSEXIT, SYSCALL/SYSRET, Intel virtualization
CPU 2: Intel(R) Xeon(R) CPU E3-1270 V2 @ 3.50GHz (6999.9 bogomips)
                        Hyper-Threading, x86-64, MMX, Physical Address Ext, SYSENTER/SYSEXIT, SYSCALL/SYSRET, Intel virtualization
CPU 3: Intel(R) Xeon(R) CPU E3-1270 V2 @ 3.50GHz (6999.9 bogomips)
                        Hyper-Threading, x86-64, MMX, Physical Address Ext, SYSENTER/SYSEXIT, SYSCALL/SYSRET, Intel virtualization
CPU 4: Intel(R) Xeon(R) CPU E3-1270 V2 @ 3.50GHz (6999.9 bogomips)
                        Hyper-Threading, x86-64, MMX, Physical Address Ext, SYSENTER/SYSEXIT, SYSCALL/SYSRET, Intel virtualization
CPU 5: Intel(R) Xeon(R) CPU E3-1270 V2 @ 3.50GHz (6999.9 bogomips)
                        Hyper-Threading, x86-64, MMX, Physical Address Ext, SYSENTER/SYSEXIT, SYSCALL/SYSRET, Intel virtualization
CPU 6: Intel(R) Xeon(R) CPU E3-1270 V2 @ 3.50GHz (6999.9 bogomips)
                        Hyper-Threading, x86-64, MMX, Physical Address Ext, SYSENTER/SYSEXIT, SYSCALL/SYSRET, Intel virtualization
CPU 7: Intel(R) Xeon(R) CPU E3-1270 V2 @ 3.50GHz (6999.9 bogomips)
                        Hyper-Threading, x86-64, MMX, Physical Address Ext, SYSENTER/SYSEXIT, SYSCALL/SYSRET, Intel virtualization
23:52:26 up  1:20,  1 user,  load average: 0.11, 0.04, 0.01; runlevel

------------------------------------------------------------------------
Benchmark Run: 木 11月 27 2025 23:52:26 - 00:20:26
8 CPUs in system; running 1 parallel copy of tests

Dhrystone 2 using register variables       48585798.3 lps   (10.0 s, 7 samples)
Double-Precision Whetstone                     6894.4 MWIPS (9.9 s, 7 samples)
Execl Throughput                               3307.6 lps   (30.0 s, 2 samples)
File Copy 1024 bufsize 2000 maxblocks        833406.9 KBps  (30.0 s, 2 samples)
File Copy 256 bufsize 500 maxblocks          214635.3 KBps  (30.0 s, 2 samples)
File Copy 4096 bufsize 8000 maxblocks       2397575.7 KBps  (30.0 s, 2 samples)
Pipe Throughput                             1115448.7 lps   (10.0 s, 7 samples)
Pipe-based Context Switching                  72291.1 lps   (10.0 s, 7 samples)
Process Creation                               4089.1 lps   (30.0 s, 2 samples)
Shell Scripts (1 concurrent)                   9387.1 lpm   (60.0 s, 2 samples)
Shell Scripts (8 concurrent)                   5626.2 lpm   (60.0 s, 2 samples)
System Call Overhead                         624533.0 lps   (10.0 s, 7 samples)

System Benchmarks Index Values               BASELINE       RESULT    INDEX
Dhrystone 2 using register variables         116700.0   48585798.3   4163.3
Double-Precision Whetstone                       55.0       6894.4   1253.5
Execl Throughput                                 43.0       3307.6    769.2
File Copy 1024 bufsize 2000 maxblocks          3960.0     833406.9   2104.6
File Copy 256 bufsize 500 maxblocks            1655.0     214635.3   1296.9
File Copy 4096 bufsize 8000 maxblocks          5800.0    2397575.7   4133.8
Pipe Throughput                               12440.0    1115448.7    896.7
Pipe-based Context Switching                   4000.0      72291.1    180.7
Process Creation                                126.0       4089.1    324.5
Shell Scripts (1 concurrent)                     42.4       9387.1   2213.9
Shell Scripts (8 concurrent)                      6.0       5626.2   9377.1
System Call Overhead                          15000.0     624533.0    416.4
                                                                                                                                            ========
System Benchmarks Index Score                                        1286.7

------------------------------------------------------------------------
Benchmark Run: 金 11月 28 2025 00:20:26 - 00:48:29
8 CPUs in system; running 8 parallel copies of tests

Dhrystone 2 using register variables      218672466.2 lps   (10.0 s, 7 samples)
Double-Precision Whetstone                    45484.1 MWIPS (10.0 s, 7 samples)
Execl Throughput                              16619.5 lps   (29.8 s, 2 samples)
File Copy 1024 bufsize 2000 maxblocks       3494650.0 KBps  (30.0 s, 2 samples)
File Copy 256 bufsize 500 maxblocks          956823.8 KBps  (30.0 s, 2 samples)
File Copy 4096 bufsize 8000 maxblocks       6978073.6 KBps  (30.0 s, 2 samples)
Pipe Throughput                             4831736.1 lps   (10.0 s, 7 samples)
Pipe-based Context Switching                1178186.9 lps   (10.0 s, 7 samples)
Process Creation                              41887.2 lps   (30.0 s, 2 samples)
Shell Scripts (1 concurrent)                  46448.3 lpm   (60.0 s, 2 samples)
Shell Scripts (8 concurrent)                   6135.1 lpm   (60.0 s, 2 samples)
System Call Overhead                        2867123.1 lps   (10.0 s, 7 samples)

System Benchmarks Index Values               BASELINE       RESULT    INDEX
Dhrystone 2 using register variables         116700.0  218672466.2  18738.0
Double-Precision Whetstone                       55.0      45484.1   8269.8
Execl Throughput                                 43.0      16619.5   3865.0
File Copy 1024 bufsize 2000 maxblocks          3960.0    3494650.0   8824.9
File Copy 256 bufsize 500 maxblocks            1655.0     956823.8   5781.4
File Copy 4096 bufsize 8000 maxblocks          5800.0    6978073.6  12031.2
Pipe Throughput                               12440.0    4831736.1   3884.0
Pipe-based Context Switching                   4000.0    1178186.9   2945.5
Process Creation                                126.0      41887.2   3324.4
Shell Scripts (1 concurrent)                     42.4      46448.3  10954.8
Shell Scripts (8 concurrent)                      6.0       6135.1  10225.2
System Call Overhead                          15000.0    2867123.1   1911.4
                                                                                                                                            ========
System Benchmarks Index Score                                        6161.5

スピードテストは下り・上りともに約900Mbps程度出ていました。いい感じです。

鯖をScaleway Dediboxに移行した

Thu, 04 Sep 2025 23:39:51 +0900

タイトルの通りです。

Scalewayというフランス大手のクラウドプロバイダーのDediboxという専用サーバーを契約しました。

具体的にはSTART-2-S-SSDというプランです。

スペックとUnixBenchの結果は以下の通り

CPU:Atom C2350 2C/2T
RAM:4GB
SSD 120GB
帯域幅は最大1Gbps
4.99ユーロ(初月料金は日割り+セットアップ料金4.99ユーロでした)


========================================================================
  BYTE UNIX Benchmarks (Version 6.0.0)


  System: [REDACTED]: GNU/Linux
  OS: GNU/Linux -- 6.1.0-38-amd64 -- #1 SMP PREEMPT_DYNAMIC Debian 6.1.147-1 (2025-08-02)
  Machine: x86_64 (unknown)
  Language: en_US.utf8 (charmap="UTF-8", collate="UTF-8")
  CPU 0: Intel(R) Atom(TM) CPU C2338 @ 1.74GHz (3500.1 bogomips)
         Hyper-Threading, x86-64, MMX, Physical Address Ext, SYSENTER/SYSEXIT, SYSCALL/SYSRET, Intel virtualization
  CPU 1: Intel(R) Atom(TM) CPU C2338 @ 1.74GHz (3500.1 bogomips)
         Hyper-Threading, x86-64, MMX, Physical Address Ext, SYSENTER/SYSEXIT, SYSCALL/SYSRET, Intel virtualization
  17:47:42 up 15 min,  1 user,  load average: 0.16, 0.05, 0.01; runlevel 2025-08-30


------------------------------------------------------------------------
Benchmark Run: Sat Aug 30 2025 17:47:42 - 18:15:39
2 CPUs in system; running 1 parallel copy of tests


Dhrystone 2 using register variables        9231383.7 lps   (10.0 s, 7 samples)
Double-Precision Whetstone                     1760.5 MWIPS (10.3 s, 7 samples)
Execl Throughput                                798.1 lps   (30.0 s, 2 samples)
File Copy 1024 bufsize 2000 maxblocks        170875.0 KBps  (30.0 s, 2 samples)
File Copy 256 bufsize 500 maxblocks           45571.7 KBps  (30.0 s, 2 samples)
File Copy 4096 bufsize 8000 maxblocks        509086.6 KBps  (30.0 s, 2 samples)
Pipe Throughput                              287557.8 lps   (10.0 s, 7 samples)
Pipe-based Context Switching                  36525.9 lps   (10.0 s, 7 samples)
Process Creation                               2044.1 lps   (30.0 s, 2 samples)
Shell Scripts (1 concurrent)                   2428.6 lpm   (60.0 s, 2 samples)
Shell Scripts (8 concurrent)                    479.2 lpm   (60.1 s, 2 samples)
System Call Overhead                         249536.2 lps   (10.0 s, 7 samples)


System Benchmarks Index Values               BASELINE       RESULT    INDEX
Dhrystone 2 using register variables         116700.0    9231383.7    791.0
Double-Precision Whetstone                       55.0       1760.5    320.1
Execl Throughput                                 43.0        798.1    185.6
File Copy 1024 bufsize 2000 maxblocks          3960.0     170875.0    431.5
File Copy 256 bufsize 500 maxblocks            1655.0      45571.7    275.4
File Copy 4096 bufsize 8000 maxblocks          5800.0     509086.6    877.7
Pipe Throughput                               12440.0     287557.8    231.2
Pipe-based Context Switching                   4000.0      36525.9     91.3
Process Creation                                126.0       2044.1    162.2
Shell Scripts (1 concurrent)                     42.4       2428.6    572.8
Shell Scripts (8 concurrent)                      6.0        479.2    798.7
System Call Overhead                          15000.0     249536.2    166.4
                                                                  ========
System Benchmarks Index Score                                         322.7


------------------------------------------------------------------------
Benchmark Run: Sat Aug 30 2025 18:15:39 - 18:43:39
2 CPUs in system; running 2 parallel copies of tests


Dhrystone 2 using register variables       18319244.4 lps   (10.0 s, 7 samples)
Double-Precision Whetstone                     3510.5 MWIPS (10.3 s, 7 samples)
Execl Throughput                               1457.4 lps   (30.0 s, 2 samples)
File Copy 1024 bufsize 2000 maxblocks        335584.4 KBps  (30.0 s, 2 samples)
File Copy 256 bufsize 500 maxblocks           88675.4 KBps  (30.0 s, 2 samples)
File Copy 4096 bufsize 8000 maxblocks        948850.0 KBps  (30.0 s, 2 samples)
Pipe Throughput                              573391.9 lps   (10.0 s, 7 samples)
Pipe-based Context Switching                  59448.4 lps   (10.0 s, 7 samples)
Process Creation                               4304.8 lps   (30.0 s, 2 samples)
Shell Scripts (1 concurrent)                   3653.2 lpm   (60.0 s, 2 samples)
Shell Scripts (8 concurrent)                    484.0 lpm   (60.1 s, 2 samples)
System Call Overhead                         503227.4 lps   (10.0 s, 7 samples)


System Benchmarks Index Values               BASELINE       RESULT    INDEX
Dhrystone 2 using register variables         116700.0   18319244.4   1569.8
Double-Precision Whetstone                       55.0       3510.5    638.3
Execl Throughput                                 43.0       1457.4    338.9
File Copy 1024 bufsize 2000 maxblocks          3960.0     335584.4    847.4
File Copy 256 bufsize 500 maxblocks            1655.0      88675.4    535.8
File Copy 4096 bufsize 8000 maxblocks          5800.0     948850.0   1635.9
Pipe Throughput                               12440.0     573391.9    460.9
Pipe-based Context Switching                   4000.0      59448.4    148.6
Process Creation                                126.0       4304.8    341.6
Shell Scripts (1 concurrent)                     42.4       3653.2    861.6
Shell Scripts (8 concurrent)                      6.0        484.0    806.6
System Call Overhead                          15000.0     503227.4    335.5
                                                                  ========
System Benchmarks Index Score                                         577.5

CPUは実際はAtom C2338でした。しかし性能に違いはないようで、海外掲示板でも他の鯖会社の事例ですがAtom C2350と書いているのにC2338だったという投稿がされています。

Giteaの2FA(2段階認証)を紛失した場合の管理者対処方法

Sun, 01 Jun 2025 12:24:00 +0900

2025/6/8 タイトルを分かりやすくし自身が管理者であるGiteaでしか使えないことを一応追記

皆さんは2段階認証（以下2FA）を利用しているだろうか。

今回、Giteaの自身の2FAの認証情報・リカバリーキーを紛失してしまい、意図せずロックアウトされてしまったので対処法を紹介する。

日本語情報がなかったので私と同じような状況に陥ってしまった者の役に立つことを願う。

当方の環境

Debian 12
Gitea 1.22.3
MariaDB(MySQL 互換)
2FAにGoogle Authenticatorを利用

本記事の内容を実行すべき人

本記事は自身が管理者であるGiteaにログインできなくなった人を対象としています。他者が運用しているGiteaサーバーで自身が2FAを紛失した場合は当然この方法は使えないので当該運営者に連絡する必要がある。

CLI上から2FAを無効化できない！！

まず、Giteaでは管理者アカウントで2FAを紛失してしまった場合、CLIのgiteaコマンド等で2FAを無効化することはできない。

DBを操作する必要がある。以下に一連の手順を示す。

Giteaを停止する

まず、自身のサーバ上で稼働しているGiteaを停止する。

systemdに登録している場合以下のコマンドで停止できる。

systemctl stop gitea

バックアップを取る（重要！！）

操作を誤ってしまった時の為にバックアップを取ることをおすすめする。

まずは、Giteaをインストールしたユーザに切り替える。ここではgitとする。

su git

そしてGiteaのインストールディレクトリまで移動し、以下のコマンドを実行する。

PATHが通っている場合、インストールディレクトリまで移動しなくてもよい。./を消して実行できる。

./gitea dump -c Giteaの設定ファイルのパス

もし以下のエラーが出た場合、当該ディレクトリに書き込み権限がないということである。

2025/06/01 00:00:00 cmd/dump.go:102:fatal() [F] Unable to create dump file "/usr/local/bin/gitea-dump-0000000000.zip": open /usr/local/bin/gitea-dump-0000000000.zip: permission denied

なのでとりあえず以下のコマンドのように-fで自身のホームディレクトリと保存したいファイル名を指定すればよい。

./gitea dump -c Giteaの設定ファイルのパス -f バックアップファイルを置きたいディレクトリとファイル名のパス
例：./gitea dump -c /etc/gitea/app.ini -f /home/git/gitea-dump-for2fa-recovery.zip

なお-fで保存先を指定しなかった場合実行したディレクトリ上に配置される。

MySQLにログインする

以下のコマンドでMySQLにログインする。

なお、DBの接続情報やDB名を忘れた場合Giteaの設定ファイルに書かれているのでそれを使えばよい。

mysql -u ユーザー名 -D GiteaをインストールしたDB名 -p

このコマンドを実行した後パスワードを求められるので入力する。

Linktecho 開発状況

Thu, 13 Mar 2025 20:45:52 +0900

Linktechoの開発状況ですが、最近まで多忙であまり進んでいませんでした。

現在要件定義をほとんど終えたところで、多言語対応を考えていたのですが思ったより難しそうで頭を抱えています…

どういったデザインやシステムにするかという考えは浮かんでるので来週中にも設計は終わる見込みです。

はじめまして

Thu, 13 Mar 2025 20:27:30 +0900

はじめまして。furu04です。

書いてなかったブログを消してポートフォリオサイト兼ブログという形でリニューアルしました！

ころころデザイン変わるかも知れませんがよろしくお願いします！