Gopher・HTTP に代わるインターネットプロトコル Gemini についてまとめています。

Google による同名 AI アシスタント とは 関係ありません。
それについてはこのページでは一切触れていませんので、ご注意下さい。

2019年6月 に Gemini Project が開始された新しいインターネットプロトコルです。
Gopher と HTTP の中間位の仕様となっています。

このページで   が付くリンクは gemini: へのリンクです。
 Gemini クライアント か  プロキシ が必要になります。
インストール状態によってはクリック・タップでクライアントが起動し表示されますが、
うまくいかない場合は URL をコピーして、
 Gemini クライアント か  プロキシ の URL のところに貼り付けて参照して下さい。

目次

公式サイト

ここでは https で公開されているリンク

•  Project Gemini - 公式サイト (HTTPS)
  • FAQ
  • news
  • documentation
    • Geminiプロトコルのドキュメント - 日本語ドキュメント
  • history
  • software
•  Project Gemini - 公式サイト (Gemini)
  • FAQ
  • news
  • documentation
    • Geminiプロトコルのドキュメント - 日本語ドキュメント
  • history
  • software

公式サイト Project Gemini は 2025年6月 現在、
HTTPS と Gemini で同じテキスト内容が表示されています。

とりあえず Geminispace を見てみる

Gemini プロトコルを用いてネット上に公開されたリソース全体を Geminispace と言います。

とりあえず Gemini を HTTPS に変換して表示できるプロキシサービスがあるので、
まずはここから Gemini の雰囲気を確認してみると良いでしょう。

 Smolnet Portal
 Wobbly
 gemini.tildeverse.org

次のページは Gemini の初歩的な説明や OS 別で主なクライアントが紹介されています。

 Gemini Quickstart! -  Gemini

Gemini クライアント

Gemini が気になったら、Gemini クライアントをインストールしましょう。
Web ブラウザのように使えます。

今のところ、クライアントがどんどん作られている状況にありますので、
一覧ページをリンクします。

 Gemini software  Cliends | Project Gemini
 Gemini (protocol)  Software | Wikipedia (English)
 ~kr1sp1n/awesome-gemini  Clients | git.sr.ht

なお、Gemini クライアントでは翻訳機能がないケースがほとんどなので、
英語などの翻訳を必要とする場合は  プロキシ で見るのも良いでしょう。

GemiNaut

 GemiNaut | MarmaladeFoo
 LukeEmmet / GemiNaut | GitHub

Windows 用の Gemini クライアントです。
テーマがいくつか存在し、表示デザインを切り替えて使用できます。

公式サイト右の Download からダウンロードページに入れます。
メールアドレスは任意で、新バージョンの通知用とあります。
.msi ファイルをインストールです。

メニューバー表示からもわかるように、機能は少なく英語表示ですが、
日本語のページが正常に表示できます。

Lagrange

 Lagrange | skyjake.fi -  Gemini
 skyjake / lagrange | GitHub

様々な OS に対応しているので、OS 関係なく使うのにおすすめです。
最近の Web ブラウザのように使う事ができます。

Windows では 🎈 Scoop だと Extras パッケージに含まれています。

scoop bucket add extras
scoop install lagrange

Preferences より左サイドバー General 内の「Language」で 日本語-ja を選択し、
UI のいくつかを日本語表示にできます。しかし、日本語が □ になってしまうので、
サイドバー下にある Manage Fonts… を選択し、「Fonts」ページを表示、
Download new fonts を選択し、「Font Library」ページを表示、
「International」の CJK fonts を選択し、「CJK」ページを表示、
下の Noto Sans CJK を選択してダウンロードします。
ダウンロードが完了すると下にメニューが表示されるので
Enable “notosans-cjk” を選択して下さい。
これで UI の日本語が表示され、日本語ページも表示できるようになります。

Gemtext

Gemini で表示されるマークアップ言語は Gemtext です。
●●●.gmi のファイル名で作成します。
日本語・絵文字を含む場合、文字コードは UTF-8 となります。
index.gmi は YRL からファイル名を省略できます。

触れていない部分はテキストとしてそのまま表示されます。

リンク

行頭 => ではじまる行はリンクになります。空白必須なのにご注意下さい。
=> の後は半角スペース 1 文字が通常用いられますが、
何文字でも有効で、空白なしでも動作します。

=> gemini://example.net.eu.org/index.gmi

URL の後ろにラベルを含める事ができます。URL とラベルの間のスペースは 1 文字以上です。

=> gemini://example.net.eu.org/index.gmi サンプル

クライアントもリンクのところには通常 => ⇛ ➤ 等の右矢印を表示しますが、
クライアントによっては URL に続くラベルの前に Unicode 絵文字 があると、
これを代わりに使用します。次だと 🎈 が行頭になるクライアントがあります。

=> gemini://example.net.eu.org/index.gmi 🎈 サンプル

主に gemini: がリンク先になりますが、
もちろん他のプロトコル https: なども可能です。
http: ・ https: であれば、Web ブラウザでの表示になります。
プロトコルを省略もでき、相対リンクも可能です。

画像ファイルなどをリンクに入れる事もできます。
GUI タイプのクライアントだと、URL のクリック・タップで画像をダウンロードし表示します。

見出し

# ・ ## ・ ### の 3 種類あります。

# 見出し

## サブ見出し

### サブサブ見出し

Markdown と共通しているようですが、**# ・ ## ・ ### の後ろは半角スペース必須です。

リスト

* ではじまる行を連続する事でリストになります。

* 項目１
* 項目 2
* 項目 3

* の後ろは半角スペース必須です。

引用

> ではじまる行は引用となります。

> 風船をもらいにいきたい！ 彼女はそう言った。

フォーマット済みのテキスト

``` で囲まれた行は整形済みテキストとなります。
上記の行頭ではじまる行があっても処理されず、そのまま表示されます。
また、等幅フォントを用いて表示されます。

```
10 INPUT A
20 INPUT B
30 C=A+B
40 PRINT C
50 END
```

Markdown 同様、開始時の ``` に続いて
プログラミング言語などを入れても構いません。

他に関連するファイル

次は HTTP・HTTPS と同じように設定し動作します。

• robots.txt - クローラーの参照範囲など。Gemini のクローラーもあります。
• RSS・Atom フィード - gemlog など。アンテナなどで反映されます。

他に favicon.txt がドラフト仕様として存在します。ドメイン直下に入れます。
Unicode 絵文字 1 文字の後に改行を入れます。
対応クライアントはドメイン内この絵文字を表示します。

🎈

ただし、対応していないクライアントが多いと思われ、
設定している利用者は少なそうです。

Gemini Capsule をホスティングで公開する

Gemini のサイトを Camsule と呼びます。いくつかの公開手段があります。
すでにホスティングサービスもいくつか存在し、そちらを使用できまます。

sourcehut pages

 sourcehut
 sourcehut pages

sourcehut は GitHub・GitLab・SourceTree のようなソースを公開する場所で、
登録したユーザーは Web サイトを公開できるようになっています。
ユーザー名.srht.site の他、 独自ドメインも設定・公開可能です。
この sourcehut pages は HTTPS による Web サイトだけではなく、
Gemini のホスティングにも対応しています。
2025年6月現在、Gemini のホスティングでは最も安定していて大規模なサーバーでしょう。

 sourcehut pages - Gemini

Gemini への公開手順は Gemini 側で公開されています。
したがって HTTPS と説明が一部異なります。

公開する手順は次の通りです。なんと tar と curl で公開できます。
Windows・Chrome OS 以外の OS では tar や curl がお馴染みのコマンドですが、
現在 Windows も tar ・ curl 共に入っているので、同じコマンドで使用できます。

sourcehut のアカウントを登録していない場合は
 meta.sr.ht からアカウントを登録します。
「Register as a contributor」の Sign up for free で無料登録できます。
Username・Email address・Password を入力します。
この時の Username が ●●●.srht.site の ●●● になります。
メール認証も入るので、受信できるメールアドレスである事を確認して下さい。

 パーソナルトークン | meta.sr.ht ページでトークンを発行します。
ランダムな文字列が表示されますので、これを保存して下さい。
トークンはパスワード同等ですので、絶対にネット公開しないで下さい！

特定フォルダ内に index.gmi などを作成しておきます。
できたら次のコマンドで site.tar.gz を作成します。

tar -C フォルダ -cvzf site.tar.gz .

次のコマンドでデプロイします。

curl --oauth2-bearer "トークン" -Fcontent=@site.tar.gz -Fprotocol=GEMINI https://pages.sr.ht/publish/ユーザー名.srht.site

※ -Fprotocol=GEMINI を外すと HTTPS（ index.html など）で公開できます。

Gemini クライアントで gemini://ユーザー名.srht.site/ を参照してみて下さい。

🎈 sourcehut | ふうせん🎈 FU-SEN 📒 WIKI

🐟flounder!

🐟 flounder! -  Gemini

無料の Gemini Web ホスティングです。
小規模な Gemini Web ページはこちらから作成してみるのも良いでしょう。
HTTPS への変換も行われ、Web ブラウザからでもほぼ同じように表示できます。
まだ Gemini を知らない人でも Web ブラウザから見てもらう事が可能です。

🐟️ Register | flounder!

上のリンクからアカウントの登録ができます。
Username が ●●●.flounder.online の ●●● になります。
ページの下にも記載があるとおり、申請してもすぐに使用できません。
管理者の承認によりアカウントが登録されます。メールで返信が届きます。

🐟 Tips and Tricks | flounder!

flounder! 特有の仕様として、次があります。

• index.gmi がない場合はファイル一覧を表示します。メニューの代用になります。
• / 区切りのファイル名を生成して、フォルダの生成になります。
  フォルダ内でも index.gmi の有無が有効です。
• gemlog フォルダを作成して Gemlog を作成できます。
  .gmi ファイルは YYYY-MM-DDテキスト.gmi とします。
  1 行目は # タイトル で始めて下さい。
• .hidden フォルダ内はまだ公開したくないファイルを入れる事ができます。
• ファイルサイズは最大 1MB、ユーザー每に 10MB、1024 ファイルまで入ります。
  画像などを入れると容量オーバーになるので、圧縮して下さい。

🐟 Custom Domains | flounder!

独自ドメインも設定して使用する事ができます。

gemlog.blue

 gemlog.blue

Gemini でブログを行う事を Gemlog と表記します。
genlog.blue は容易に Gemlog を実現できます。
素早く Gemtext で記載して公開できるので、
 サーバー を建てるのが困難な場合は
代わりに gemlog.blue へテスト投稿しるる慣らすのも良いかもしれません。
ページ運営者がアカウントを登録し、日本語・絵文字付で投稿して、
問題なく Gemini クライアント で表示できる事を確認できています。

 Create an account からアカウントを作成します。
すぐに登録され gemini://gemlog.blue/users/ユーザー名/ で参照できるようになります。
 add a gemlog entry から投稿します。
ユーザー名・パスワードが含まれます。これだけで Gemlog ページが公開できます。
 投稿の編集 や  削除 も可能です。
Gemini にはフォームの仕様がないので、投稿関連は HTTPS で提供されています。

 gemlog.blue

Gemini 側で参照すると少し表示が異なっていて、ユーザーの一覧も参照できます。
実際見てみるとテスト投稿で 1 ページ～数ページ投稿している位のユーザーが多いです。
英語投稿が多いですが、他国語も見られ、絵文字などをテストしているユーザーもありました。

Gemini Capsule をサーバーを建てて公開する

今のところ、サーバーがどんどん作られている状況にありますので、
一覧ページをリンクします。
Gemini プロトコルがデフォルトで使用するポート番号は 1965 です。
また SSL 証明書が必要 で、TOFU（Trust on first use）原則となっています。

 Gemini software  Servers | Project Gemini
 ~kr1sp1n/awesome-gemini  Servers | git.sr.ht

Agate

 mbrubeck/agate | GitHub

静的ファイルを公開するシンプルな Gemini サーバーです。
数多く Gemini サーバーが開発されている中、Agata がよく紹介されているケースが多いです。
というのも、Gemini はローカルでの参照でも SSL 証明書が必要になり、
HTML ファイルのように Web ブラウザでファイルを直接表示する事ができません。
Agata は SSL 証明書が存在しない場合、自己証明書を自動的に発行し、それを適用します。
そのため、Agata であれば、証明書の発行を対応する事なく、
次の１行でローカルサーバーを建ててすぐに動作確認できます。

agate --content (.gmi ファイルがあるフォルダ) --addr 0.0.0.0:1965 --hostname localhost --lang ja-JP

Gemini クライアントで gemini://localhost/ で参照できます。

--hostname ドメイン名 にして、ポート 1965 で参照できるようにすれば、
そのドメインで参照できるようになります。
なお、 --hostname ドメイン名 を複数指定して運用する事もでき。
その場合は --content フォルダ で指定したフォルダに対し、
フォルダ/ドメイン名/ 内を参照するようになります。

なお、ネット公開する場合は Let’s Encrypt などの
認証された SSL 証明書を使用する事になります。
起動フォルダに作られている .certificates フォルダに
ドメイン別で 証明書 cert.der と 鍵 key.der を入れます。
指定ドメインがない場合、フォルダ直下の cert.der ・ key.der が有効です。
.certificates フォルダを変えたい場合は ``–certs フォルダで指定できます。\ フォルダを変更した場合は物理的なフォルダの変更も手動で行って下さい。\ 作業を行わずlocalhost` で自己発行した証明書を再度発行すると、
クライアントによっては証明書の更新が検知されず、エラーになる場合があります。
この場合は移動前の証明書を現在のフォルダ内へ上書きする事で改善できます。

Agate 独自の設定ファイルとして、次が存在します。

• .directory-listing-ok - このファイルが入っているディレクトリは
  index.gmi がない場合にファイル一覧表示となります。ファイルの中身は空です。
• .meta - 特定のファイルやフォルダ每に細かく設定ができます。
  例えば次のような感じになります。

# この行は無視されます。
**/*.jp.gmi: ;lang=jp-JP
en/**/*.gmi: ;lang=en
index.gmi: ;lang=jp
LICENSE: text/plain;charset=UTF-8
gone.gmi: 52 This file is no longer here, sorry.

Gemini をもっと楽しむ

Geminispace の巡回

 Anntena | warmedal.se - アンテナ
 Kennedy: Search Gemini Space | - 検索エンジン
 AuraSearch - 検索エンジン
 TLGS - “Totally Legit” Gemini Search - 検索エンジン
 Fumble Around - 登録されたページをランダム表示

静的サイトジェネレータ

 ustlark/gempost | GitHub
 snonux/gemtexter | Codeberg
 kconner/gloggery |GitHub
 ~gsthnz/gssg | sourcehut
 ~adnano/kiln | sourcehut
 mkamarin/Hugo-2-Gopher-and-Gemini | GitHub

その他

 ~kr1sp1n/awesome-gemini | git.sr.ht

Q&A

Gemini のポート番号 1965 は何か意味がありますか？

 ジェミニ3号 | Wikipedia

ジェミニ計画として初めて有人で打ち上げられた ジェミニ３号 が
1965 年 3 月に打ち上げ～着水しています。

Gemini に日本のページは存在しますか？

公開している人はいますが、まだ少ないです。
ただし英語以外の言語でページを公開している人も見られ、
様々な国・地域から利用者がいるように見えます。

Gemini をローカルで確認する方法はサーバー以外にありますか？

 Gemini and Hugo | sylvain durand

🎈 Hugo を用いている場合、
Gemini の .gmi ファイルに対応して出力する方法があります。

入力枠が表示されたのですが、どのようにしているのですが？

Gemini サーバーによっては CGI を用いて
任意のプログラミング言語を経由して動作できます。
ステータスコードで 10 を返すと、クライアントで入力欄を表示できます。
入力した内容は同じ URL の末尾に ?入力内容 で送られるので、
これでサーバーは入力のウムで別の処理を行う事ができます。

アクセス解析などは行われていますか？

Gemini のプロトコル仕様上、アクセス数を認識する手段はありません。
サーバーレベルではアクセスログが蓄積されるので、
使用するサーバーやホスティングサービスによっては提供されるかもしれません。