Open Source Software

OSS - Open Source Software

Home Media System

Kodi, Jellyfin, Plex and Emby 家庭影音資料庫系統。

Home Media System

Jellyfin

Introduction

Jellyfin is the volunteer-built media solution that puts you in control of your media. Stream to any device from your own server, with no strings attached. Your media, your server, your way.

Installation

With Docker
# Pull the image
docker pull jellyfin/jellyfin

# Create the directories
mkdir {config,cache,video}

#Create the account
addgroup --system jellyfin
adduser --system --ingroup jellyfin jellyfin

# Set the permission
chown jellyfin.jellyfin config cache

# Run the container
docker run -d \
 --name jellyfin \
 --user $(id -u jellyfin):$(id -g jellyfin) \
 --net=host \
 --volume $(pwd)/config:/config \
 --volume $(pwd)/cache:/cache \
 --mount type=bind,source=$(pwd)/video,target=/video \
 --restart=unless-stopped \
 jellyfin/jellyfin

Quick Start

http://SERVER_IP:8096

Plugins

新增第三方套件庫位址

控制台 > 附加元件 > 儲存庫 > 新增

安裝附加元件

控制台 > 附加元件 > 目錄 > [選擇要安裝的元件] > Install

直播頻道

Storj DCS Cloud Storage

rclone mount

rclone mount storjdcs-jellyfin:media /root/jellyfin/video --vfs-che-mode full --dir-cache-time 1h  --no-checksum --no-modtime --rc

rclone mount storjdcs-jellyfin:media /root/jellyfin/video \
 --vfs-cache-mode full \
 --allow-other \
 --dir-cache-time 1h \
 --uid=$(id -u jellyfin) \
 --gid=$(id -g jellyfin) \
 --no-checksum --no-modtime --rc

Refreshing the Local Sync Location

This recursively refreshes the root directory of the Rclone mount to pick up the newly uploaded files in Storj.

rclone rc vfs/refresh -v --fast-list recursive=true

FAQ

媒體庫封面無法顯示中文。

Solution: 在主機端安裝中文字形

# On the docker host
apt install fonts-noto-cjk

# Adjust the launch command
docker run -d \
...
 --volume /usr/share/fonts:/usr/share/fonts \
 --volume /usr/share/fontconfig:/usr/share/fontconfig \
...
 jellyfin/jellyfin

清除 Browser cache，並重新登入後再試一次。

如果還是顯示不正常，清除 config/metadata/library/ 內的所有目錄，重新掃描媒體庫後再試一次。

ASS 字幕無法顯示中文。

Solution:

  1. 下載中文字型檔(網頁字型)  NotoSansCJKtc-Regular.woff2， NotoSerifCJKtc-Regular.woff2。下載位址：https://github.com/CodePlayer/webfont-noto/releases   
  2. 在主機端 docker 目錄下新增 font/ 資料夾，並將字型檔上傳到該資料夾。
  3. 修改 docker 啟動檔，在中間處加上這一行 --volume $(pwd)/fonts:/fonts \，重新啟動 container。 
  4. 開啟 Jellyfin 管理界面 > 控制台 > 播放 > Fallback font folder path: /fonts ，Enable fallback fonts: Checked 
  5. Done

rclone 掛載 StorjDCS 發生錯誤：

Fatal error: failed to mount FUSE fs: fusermount: exec: "fusermount": executable file not found in $PATH

Solution：

sudo apt install fuse





OSS & Freewares

OSS List
Good Articles to OSS
網站瀏覽統計分析 (Alternative to Google Analytics)

Plausible Analytics

Video Conference

Jitsi

Linux Backup

Restic - Commands and tools such as cp, rsync, and unison are excellent for moving data from one location to the other and even for synchronizing data. However, they are not ideal for a differential or incremental backup strategy. They are also not efficient in terms of resource usage. A good backup solution not only performs a full backup, but also examines the objects to see what has changed. It accounts for these changes and saves them accordingly with emphasis on security and efficiency. When it comes to restoration, a viable backup solution should allow for the bulk and granular restoration of files, directories, and objects based on a point-in-time. Restic checks all of the boxes when it comes to a solid backup solution.

Performance Analytics

Guider - Python-based Tools

Presentation

Make a slide with Markdown

Prezi - 沉浸式簡報

Server Performance Monitor

Collectd

Checkmk

Healthchecks - Healthchecks is a cron job monitoring service. It listens for HTTP requests and email messages ("pings") from your cron jobs and scheduled tasks ("checks"). When a ping does not arrive on time, Healthchecks sends out alerts.

可監控 Cron job，排程時間到若沒有正常執行，也可以收到告警。可以整合任何程式碼或 script 以 HTTP API 方式觸發告警。可以監控某個程式的執行時間是否過長。

Netdata - Monitor your servers, containers, and applications, in high-resolution and in real-time.

Server UpTime Monitor
Remote Control
Console & Terminal
Mail Server
中文化-多國語言翻譯 Translation

語言翻譯協作平台

中文化

Firewall & Router
Kiosk
Web Benchmark
Calendar
Active Directory
Cloud Storage
Bootable USB Drive with ISO files
Game OS
影像監視系統
NAS
Forum
Home Lab/Cloud Server
OAuth2/SSO
Audio
File Transfer
Database
Business Management
Desktop Tools
Push notification
IP Scanner
Android running Linux
IoT
其他自架服務

phpIPAM

Introduction

phpIPAM - Open source IP address management.

phpipam is an open-source web IP address management application (IPAM). Its goal is to provide light, modern and useful IP address management. It is php-based application with MySQL database backend, using jQuery libraries, ajax and HTML5/CSS3 features.

URLs:

Installation

Requirements
  1. Apache2 webserver with php support or Nginx with php-fpm
  2. Mysql server (5.1+)
  3. PHP:
    • version 5.3 supported to phpipam version 1.3.1
    • version 5.4
    • version 7.2 and higher supported from phpipam release 1.3.2
  4. PHP modules:
    • pdo, pdo_mysql : Adds support for mysql connections
    • session : Adds persistent session support
    • sockets : Adds sockets support
    • openssl : Adds openSSL support
    • gmp : Adds support for dev-libs/gmp (GNU MP library) -> to calculate IPv6 networks
    • ldap : Adds LDAP support (Lightweight Directory Access Protocol – for AD also)
    • crypt : Add support for password encryption
    • SimpleXML: Support for SimpleXML (optional, for RIPE queries and if required for API)
    • json: Enable JSON support
    • gettext: Enables translation
    • filter : Adds filtering support
    • pcntl : Add support for process creation functions (optional, required for scanning)
    • cli : Enable CLI (optional, required for scanning and status checks)
    • mbstring : Enable mbstring support
  5. php PEAR support

You can check which php modules are enabled by issuing php -m in command line.

API Develop

Enable API and Create new API Key (code)

By default, the API is Disabled, go to Enable it first.

IPAM Web > Administration > Server management > phpIPAM settings > API: ON

IPAM Web > Administration > API > Create API Key

NOTE:

如果 App security 是 User token，表示 API 連線協定使用不加密的 HTTP，這時系統會提示需要變更 config.php 的參數。

$api_allow_unsafe = true;

API Test with curl

API 使用注意

  1. 第一次連線，需要先登入 IPAM 的帳號/密碼並取得一組 Token，預設有效期是 6 小時。
  2. 每次連線 API 時，必須在 header 內包含一組有效的 Token，才能通過認證；否則會顯示 Unauthorized。
  3. 先前建立的 API Key 與 第一項的 Token 兩個是不一樣的東西，用途也不同。基本上 API Client 開發只會用到 Token。
  4. Token 一旦超過有效期，有兩種做法可以繼續 API 連線。
    • 延展已過期的 Token。
    • 以帳密重新取得新的 Token。(注意: 原 Token 將會永久失效)

以帳號取得一組 token: /api/{app_id}/user/

TIP: 相同語法也能用在驗證特定帳密是否有效。

#> curl -X POST --user admin:thisispassword http://10.10.2.207/api/devappro/user/ -i

HTTP/1.1 200 OK
Date: Wed, 15 Jun 2022 05:40:01 GMT
Server: Apache/2.4.6 (CentOS) PHP/5.4.16
X-Powered-By: PHP/5.4.16
Set-Cookie: phpipam=ttm3cg1ctpq1vqn2lv1rht3kl1; expires=Thu, 16-Jun-2022 05:40:01 GMT; path=/; HttpOnly
Expires: Thu, 19 Nov 1981 08:52:00 GMT
Cache-Control: no-cache
Pragma: no-cache
Content-Length: 116
Content-Type: application/json; charset=utf-8

{"code":200,"success":true,"data":{"token":"7dMGzul08SsPMhDDOK-oZdBk","expires":"2022-06-15 19:40:01"},"time":0.009}

查詢 token 的有效期: /api/{app_id}/user/token_expires/

#> curl -X GET http://10.10.2.207/api/devappro/user/token_expires/ --header "token: 7dMGzul08SsPMhDDOK-oZdBk"
{"code":200,"success":true,"data":{"expires":"2022-06-15 19:44:31"},"time":0.002}

延展 token 有效期: /api/{app_id}/user/

TIP: 每次延展會以 6 小時為限，多次延展也不會超過 6 小時

curl -X PATCH http://10.10.2.207/api/devappro/user/ --header "token: 7dMGzul08SsPMhDDOK-oZdBk"
{"code":200,"success":true,"data":{"expires":"2022-06-15 21:11:37"},"time":0.004}

以 IP 搜尋資料庫: /api/{app_id}//addresses/search/{ip-address}/

# IP is existed.
curl -X GET http://10.10.2.207/api/devappro/addresses/search/10.10.1.8 --header "token: 7dMGzul08SsPMhDDOK-oZdBk"
{"code":200,"success":true,"data":[{"id":"271","subnetId":"22","ip":"10.10.1.8","is_gateway":null,"description":"FAB A-VM Server-VM05","hostname":"TPECIMVM05","mac":null,"owner":null,"tag":"2","deviceId":null,"location":"3","port":null,"note":null,"lastSeen":"2022-06-15 13:30:01","excludePing":null,"PTRignore":null,"PTR":"0","firewallAddressObject":null,"editDate":"2022-06-15 13:30:10","customer_id":null}],"time":0.017}

# IP not found
curl -X GET http://10.10.2.207/api/devappro/addresses/search/10.10.1.7 --header "token: 7dMGzul08SsPMhDDOK-oZdBk"
{"code":200,"success":false,"message":"Address not found","time":0.007}

延伸閱讀