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

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

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

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

運営者が現在 Gemini で公開している Capsule は次があります。

🎈 balloonvendor.flounder.online (https:) - (gemini:) - 🐟️flounder! 使用
🎈 gemini://gemlog.blue/users/balloon/ - gemlog.blue 使用\

Project Gemini (https:) - 公式サイト (https:)
- FAQ
- news
- documentation
  - Geminiプロトコルのドキュメント - 日本語ドキュメント
- history
- software
Project Gemini (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! (https:) - (gemini:)

Gemini クライアント

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

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

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

Lagrange

Lagrange | skyjake.fi (https:) - (gemini:)
skyjake / lagrange | GitHub

様々な OS に対応しているので、OS 関係なく使うのにおすすめです。
最近の Web ブラウザのように使う事ができ、多機能です。
Argos Translate による翻訳機能も付いているので、他国語のページも翻訳して読めます。
（右クリックまたは URL 右の … より ツール・Tools - 翻訳・Translate… 。
　言語が明確な場合は指定すると翻訳がはやいです）

まともに使うなら、普通に実行ファイルをインストールして下さい。
プロトコル gemini: の割り当てが行われるので、
Web ブラウザと交互に表示できるようにできます。
ポータブル版だと gemini: の追加が行われません。

初期状態だと日本語が □ になってしまうので、
使用したい日本語フォントを Lagrange ウインドウへドラック＆ドロップするか、
Open File で日本語フォントを選択して下さい。
するとフォントのインストール画面になるので、インストールして下さい。
（ □ 表示になっている場合はメニューの一番上）
これで日本語が正常に表示できるようになります。
更に Settings より General 内の「Language」で 日本語-ja を選択すると、
メニューなどの UI も日本語表示にできます。
Lagrange 1.18.5 までは英語表示も多かったのですが、
Lagrange 1.18.6 よりほぼ日本語表示になります。
Android は Lagrange 1.18b37 よりほぼ日本語表示になっています。

なお、2025年8月現在、Lagrange から 設定・Settings にある
フォントの管理・Manege Fonts （一部の環境では フォント・Font 内）より
Noto Sans CJK をインストールできるようになっているのですが、
この方法だと日本語以外に中国語も含まれるので、
一部文字の形状がおかしくなってしまいます。

🎈 Gemini クライアント Lagrange | 🎈 balloonvendor.flounder.online (https:) - (gemini:)

けっこう便利な機能が豊富なので、Gemini からでも参照できるように
🎈 balloonvendor.flounder.online 内により詳細に機能を紹介してあります。

Gemtext

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

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

🎈 gemtext.gmi | balloonvendor.flounder.online (https:) - (gemini:) - 実際の表示サンプル

リンク

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

=> gemini://balloonvendor.flounder.online/gemtext.gmi

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

=> gemini://balloonvendor.flounder.online/gemtext.gmi Gemtext

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

=> gemini://balloonvendor.flounder.online/gemtext.gmi 🎈 Gemtext

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

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

見出し

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

# 見出し

## サブ見出し

### サブサブ見出し

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

引用

> ではじまる行は引用となります。
🎈 Markdown 共通です。複数行でも使用できます。

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

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

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

``` BASIC プログラム
10 INPUT A
20 INPUT B
30 C=A+B
40 PRINT C
50 END
```

開始時の ``` に続いてテキストの説明文を入れておく事ができます。
（ 🎈 Markdown では言語や形式を入れておくように。日本語・絵文字も可能）
クライアントによってはこの部分を畳む事が可能で、
その場合は説明文のみの 1 行表示になります。
上の例だと、畳むと BASIC プログラム と表示されます。

他に関連するファイル

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

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

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

🎈

ただし、対応していないクライアントが多いと思われ、
設定している利用者は少なそうです。
また、Unicode 絵文字ではない文字を設定しているケースも見られます。

Lagrange は「Gemini の方針に反する」という考えて
favicon.txt を採用していないのですが、
ブックマーク登録時にアイコンの項目があり、絵文字を入れる事によって、
そのサイトはアイコンの絵文字で必ず表示されるようになっています。
ブックマーク入れていない場合は URL のハッシュによって
決められた絵文字（と背景）で表示する仕様になっています。

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

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

gemlog.blue

gemlog.blue (https:)

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

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

2025年7月現在、投稿・編集後の URL をクリックしても表示できません。
投稿・編集は正常に完了していて gemini: の URL は正常なので、
他の Gemini クライアントやプロキシに貼り付けて確認してみて下さい。

gemlog.blue (gemini:)

Gemini 側で参照すると少し表示が異なっていて、ユーザーの一覧も参照できます。

sourcehut pages

sourcehut
sourcehut pages (https:)

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

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

上の -Fprotocol=GEMINI を外すと index.html を含められるようになり、
https://ユーザー名.srht.site/ で公開できます。

Custom domains with sourcehut pages

独自ドメインを設定する場合はネームサーバを設定してからとなります。
なお、Cloudflare のプロキシ経由とかは sourcehut pages では禁止されています。
画像なども sourcehub 内から配信し CDN 経由にする事も禁止となっています。
ご注意下さい。

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

🐟flounder!

🐟 flounder! (https:) - (gemini:)

運営者が登録して使用しています。
Web 上で Gemini Web ページ（Gemini Cusule）を作成でき、Gemlog も対応、
HTTP も自動変換sされ、SFTP にも対応していて、とても便利なのですが、
登録を試みて、しばらく待っても承認されないケースがある事があり、
登録を推奨できる状態ではありません。

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

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

Gemini software Servers | Project Gemini
~kr1sp1n/awesome-gemini Servers | sourcehut 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 を楽しめるように、いくつかリンクを入れておきます。

Geminispace の巡回

Anntena | warmedal.se (gemini:) - アンテナ
Cosmos | skyjake.fi (gemini:) - アンテナ
Kennedy: Search Gemini Space (gemini:) - 検索エンジン
AuraSearch (gemini:) - 検索エンジン
TLGS - “Totally Legit” Gemini Search (gemini:) - 検索エンジン
Collaborative Directory of Geminispace (gemini:) - 検索エンジン
Fumble Around (gemini:) - 登録されたページをランダム表示
BBS (gemini://bbs.geminispace.org) - 掲示板
- s/日本 - なかったので作りました
Station (gemini://station.martinrue.com) - 掲示板

静的サイトジェネレータ

その他

~kr1sp1n/awesome-gemini | sourcehut git.sr.ht - Gemini プロトコル関連の一覧
Gemini and Hugo | sylvain durand - Hugo で Gemini に対応する方法

Q&A

Project Gemini FAQ (https:) - (gemini:) も参照してみて下さい。

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

ジェミニ3号 | Wikipedia

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

Google Play に一切 Gemini クライアントがないのですが、開発されていないのですか？

Android 向けの Gemini クライアントもいくつか存在していますが、
Google が Google Play から完全に排除しているため、存在していません。
F-Droid からインストールするか、.apk ファイルを直接インストールする必要があります。
Lagrange ももちろん Android 版が存在します。

Gemini について調べたいのですが、Google のものばかりです。

gemini protocol -google -ai と除外オプションを加えて検索します。
Google で Gemini を検索すると、AI について興味があるように認知して
関連サービスで反応してくる事がありますので、DuckDuckGo での検索がおすすめです。

gemini protocol -google -ai 検索結果 | DuckDuckGo

Google Chrome を用いる場合は広告ブロッカーや DuckDuckGo の拡張機能を含めて、
Google が検出しないようにしないようにするのも有効です。
またはログインしていない状態にできるシークレットウインドウや
Firefox など、他の Web ブラウザを使用するのも有効です。

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

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

英語ページと日本語ページを用意しておくと良さそうですが、
Lagrange のように翻訳機能の付いたクライアントもあるので、
日本語だけで発信してしまっても良いと思います。

一部の場所に入る事ができません

管理メニューなど、個人を認証する場所については
自分を認証するために証明書を生成する必要があります。
クライアントによって、その時に証明書を生成するメニューが表示されたり、
メニューに証明書生成がありますので、証明書を生成して下さい。
その後入る事ができるでしょう。

画像は表示できますか？

画像ファイルをアップロードし、=> 画像ファイル名 でリンクすると、
グラフィカルなクライアントであれば、クライアント内で画像を表示できます。
（ https: へのリンクだと Web ブラウザへ移っての表示になります）
ただし、クライアントにはテキストで使用するケースもあるので、
画像が見られるとは限らない点にご注意下さい。

画像の内容によっては Ascii Art へテキスト化してしまうのも手です。
``` で囲む事で等幅フォント表示にすると良いでしょう。

🎈 anko.gmi | balloonvendor.flounder.online (https:) - (gemini:) - あんこ……

Gemini と HTTPS 共通でサイトを作成していますが、同じプロトコルへのリンクはどうすれば良いですか？

リンク先のページも Gemini・HTTPS 両方存在していて、
Gemini で参照している場合は gemini: へ、
HTTPS で参照している場合は https: へ参照したい場合は
これらのプロトコル部分を省略して // から記載して下さい。

=> //srht.site/ ◯ sourcehut pages

このようにすると、 Gemini で参照している場合は gemini://srht.site/ 、
HTTPS で参照している場合は https://srht.site/ へのリンクとなります。

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

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

入力枠やリンクの仕組みだけでゲームも公開されてますし、
掲示板も制作・公開されています。
HTTP に比べて制限されている Gemini でも、やる気とアイデア次第では、
様々なものがつくれる、という事を表してくれています。

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

Gemini のプロトコル仕様上、アクセス数を認識する手段はありません。
そもそも Gemini ができた経緯として、現代のアクセス解析が一因と思われるので
そのような事ができにくいプロトコルを構築したように思われます。

ただし、Gemini サーバーレベルではアクセスログが蓄積できるので、
使用するサーバーやホスティングサービスによっては
アクセス数などを提供できる・されるかもしれません。

Gemini（インターネットプロトコル）

目次

公式サイト