# アクセス解析ツール Umami の導入
**URL:** https://forum.ficusonline.com/t/topic/565
**Category:** Server
**Tags:** umami
**Created:** [2026 年 8 月 27 日午前 9:05 UTC](https://forum.ficusonline.com/t/topic/565 "2026-08-27T09:05:26Z")
**Posts on this page:** 3
**Page:** 1
### Author:  [@tk-fuse](https://forum.ficusonline.com/u/tk-fuse)
#### Post date: [2026 年 8 月 27 日午前 9:05 UTC](https://forum.ficusonline.com/t/topic/565/1 "2026-08-27T09:05:27Z")
docker-compose
>
ドキュメント
> **[Introduction – umami](https://docs.umami.is/docs)**
>
> Documentation for Umami, a modern privacy-focused analytics platform.
.envとdocker-compose.ymlの作成
`docker-compose.yml`
```yaml
services:
umami:
image: ghcr.io/umami-software/umami:latest
container_name: umami
ports:
- "3080:3000"
environment:
DATABASE_URL: postgresql://${DB_USER}:${DB_PASSWORD}@umami-db:5432/${DB_DATABASE}
APP_SECRET: ${SECRET}
TWO_FACTOR_ENCRYPTION_KEY: ${KEY}
depends_on:
umami-db:
condition: service_healthy
init: true
restart: always
healthcheck:
test: ["CMD-SHELL", "curl http://localhost:3000/api/heartbeat"]
interval: 5s
timeout: 5s
retries: 5
umami-db:
image: postgres:16-alpine
container_name: umami-db
environment:
POSTGRES_DB: ${DB_DATABASE}
POSTGRES_USER: ${DB_USER}
POSTGRES_PASSWORD: ${DB_PASSWORD}
volumes:
- ./umami-db-data:/var/lib/postgresql/data
restart: always
healthcheck:
test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"]
interval: 5s
timeout: 5s
retries: 5
```
> 注）ホストのポート3000は使用中のため3080へ変更。.envでユーザ名、パスワードなどを指定。
`.env`
```auto
### # Required for two-factor authentication, generate with: openssl rand -hex 32
KEY="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
### $ uuidgen
SECRET="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
DB_DATABASE="umami"
DB_USER="umami"
### $ pwgen -s 15 1 or $ openssl rand -base64 16
DB_PASSWORD="xxxxxxxxxxxxxxxxxxxxxxx"
```
起動
```shell
$ docker compose up -d
```
ステータス
```shell
$ docker compose ps
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
umami ghcr.io/umami-software/umami:latest "docker-entrypoint.s…" umami 2 hours ago Up 2 hours (healthy) 0.0.0.0:3080->3000/tcp, [::]:3080->3000/tcp
umami-db postgres:16-alpine "docker-entrypoint.s…" umami-db 2 hours ago Up 2 hours (healthy) 5432/tcp
```
#### アクセス：http://\:3080
ユーザ名：admin
パスワード：umami
**ログイン画面**
**ユーザ名・パスワード変更**
ユーザ名とパスワードはログイン後変更すること。
**サイト追加**
> 注）Nginxのプロキシを利用してパブリックドメインでアクセスできるようにすること。
> 例）[https://umami.example.com](https://umami.example.com)
---
### Author:  [@tk-fuse](https://forum.ficusonline.com/u/tk-fuse)
#### Post date: [2026 年 8 月 28 日午前 6:20 UTC](https://forum.ficusonline.com/t/topic/565/2 "2026-08-28T06:20:01Z")
## トラブルシュート
### アクセス元の地域、都市が表示されない
>
>
> \### Describe the Bug
>
> No region and cities are showing in Umami dashboard, while… countries are showing.
> Countries:
> \
> Region:
> \
> Cities:
> \
>
>
> \### Database
>
> PostgreSQL
>
> \### Relevant log output
>
> \_No response\_
>
> \### Which Umami version are you using? (if relevant)
>
> v2.10.2
>
> \### Which browser are you using? (if relevant)
>
> Chrome
>
> \### How are you deploying your application? (if relevant)
>
> Docker
**Cloudflareの設定**
domain → Rules → Settings → Managed Transforms
> **Add visitor location headers**
Cloudflareを経由している場合、リクエストは実質的に **クライアント → Cloudflareのエッジサーバー → オリジン(Nginx→Umami)** という経路になります。この構成では、オリジン側(Umamiのnode-geoip処理)が見ているIPは最終的に正しいクライアントIPになりますが、Cloudflare自体が既に **独自の高精度な位置情報判定** を行っており、それを `CF-IPCountry`, `CF-IPCity`, `CF-Region` などの専用ヘッダーとして付与できる仕組みを持っています。
「Managed Transforms → Add visitor location headers」を有効にすることで、Cloudflareが位置情報ヘッダーをオリジンまで転送するようになるため、Umami(または対応しているアプリ)側でそれを利用できるようになります。
---
### Author:  [@tk-fuse](https://forum.ficusonline.com/u/tk-fuse)
#### Post date: [2026 年 8 月 28 日午前 6:35 UTC](https://forum.ficusonline.com/t/topic/565/3 "2026-08-28T06:35:36Z")
## Nuxtフレームワークへ導入
> **[Proxy Mode - Configuration](https://umami.nuxt.dev/api/configuration#proxy-mode)**
>
> Add umami to your Nuxt config. | Configure Nuxt Umami to work with your app.
nuxt-umamiのインストール
```shell
$ docker run --rm -it --env-file ./agency-os/.env \
-v "$(pwd)/agency-os:/app" -w /app node:24-alpine \
sh -c "corepack enable && corepack prepare --activate && \
pnpm install --frozen-lockfile && pnpm add -D nuxt-umami"
```
上記パッケージをインストール後`nuxt.config.ts`に設定を追加
`agency-os/nuxt.config.ts`
```auto
export default defineNuxtConfig({
modules: [
'nuxt-umami'
],
umami: {
host: 'https://umami.ficusonline.com',
id: 'a8226e9a-73ee-444b-9006-8300ef72300c',
autoTrack: true,
// 開発環境でもテスト送信したい場合は true、止めたい場合は false
// （旧 logModal は廃止されたため、テスト環境での無効化等は ignoreLocal などを使用）
ignoreLocal: true, // localhostからのアクセスを除外する場合
},
});
```
リビルド
> 注）corepackを使用しないとpackage.jsonで指定したpnpmのパージョンが採用されないためビルドエラー
```auto
$ docker run --rm -it --env-file ./agency-os/.env
-v "$(pwd)/agency-os:/app" -w /app node:24-alpine
sh -c "corepack enable && corepack prepare --activate && \
pnpm install --frozen-lockfile && pnpm build"
```
* * *
## Discourseへ適用
テーマとコンポーネント—\>テーマの編集—\>カスタムコード—\>コードを編集
\タグにumamiで取得したトラッキングコード追加
```auto
```
* * *
## Prestashopへ適用
テーマのhead.tplへトラッキングコードを追加
`themes/classic/templates/_partials/head.tpl`
```auto
{block name='hook_extra'}
{/block}
```
> 注）アップデート後にファイルが更新されるため、その都度置き換える必要あり。