下載 myTickrs 到你的電腦

執行桌面應用程式有 3 種方式：

1. 安裝：依你的系統執行一行指令。
2. 在 Docker 中執行：在你的電腦或家用伺服器上。
3. 從原始碼執行：使用 GitHub 上的程式碼。

不想安裝任何東西？可以改為在瀏覽器中使用 myTickrs。

1. 安裝

開啟終端機，貼上適用於你系統的那一行，然後按 Enter。安裝程式需要 Node.js 24 或更新版本；如果沒有或版本太舊，它會先徵求你的同意再幫你安裝。

Windows

開啟 PowerShell（按下「開始」，輸入「PowerShell」），然後執行：

macOS

開啟終端機（在「應用程式 → 工具程式」中），然後執行：

Linux

開啟終端機，然後執行：

安裝程式會做什麼

1. 檢查是否有 Node.js 24 或更新版本。如果沒有，它會徵求許可後再安裝：在 Windows 上使用 winget 或官方安裝程式，在 macOS 上使用官方安裝程式，在 Linux 上使用 NodeSource（apt、dnf 或 yum）或安裝到 ~/.local/node 的官方版本。安裝 Node.js 時可能需要輸入系統管理員密碼。
2. 下載最新版 myTickrs，解壓縮到你主資料夾中的 mytickrs 資料夾（Windows 上為 %USERPROFILE%\mytickrs，macOS 與 Linux 上為 ~/mytickrs）。若要使用其他資料夾，請在執行前設定 MYTICKRS_DIR。
3. 安裝相依套件並新增 myTickrs 捷徑：Windows 上放在桌面與「開始」功能表，macOS 上放在「應用程式」並在桌面建立連結，Linux 上放在應用程式選單與桌面。
4. 啟動應用程式並在瀏覽器中開啟。如果瀏覽器沒有開啟，請前往 http://localhost:5050。

先閱讀腳本

把腳本透過管線交給 shell 執行，就代表你信任這個腳本，所以請在執行前先閱讀。以下就是本頁指令所下載的檔案：

• install.ps1（Windows）
• install-macos.sh（macOS）
• install-linux.sh（Linux）
• install-docker.ps1（Windows 上的 Docker）
• install-docker.sh（macOS 與 Linux 上的 Docker）

我們計畫推出 Windows 與 macOS 的簽署安裝程式，屆時就完全不需要終端機。

啟動、更新與移除

之後再次啟動

按兩下 myTickrs 捷徑。它會在終端機視窗中啟動應用程式並開啟瀏覽器；如果應用程式已在執行，則只會開啟瀏覽器。關閉該視窗（或在其中按 Ctrl+C）即可停止應用程式。

更新

先停止應用程式，再執行一次安裝指令。新版本會取代舊版本，你的資料庫（data/）、設定（.env）以及你加入的外掛都會保留。

備份

你的投資組合就是安裝資料夾中的 data/tickrs.db 檔案。複製它即可備份，或移到另一台電腦。你也可以在設定 → 同步中開啟與 myTickrs 雲端帳號的同步來備份與還原；除非你開啟，否則同步是關閉的。

解除安裝

先停止應用程式，再刪除安裝資料夾和 myTickrs 捷徑。這也會刪除你的資料庫，如果想保留，請先備份 data/。

2. 在 Docker 中執行

不想安裝 Node.js，或想在家用伺服器或 NAS 上執行 myTickrs？那就改用 Docker。映像檔是 GitHub Container Registry 上的 ghcr.io/mytickrs/mytickrs，支援 x86-64 與 ARM（包括 Apple 晶片）。

Windows

在 PowerShell 中：

macOS 與 Linux

在終端機中：

Docker 安裝程式：

1. 檢查是否有 Docker 與 Docker Compose。如果沒有，它會徵求許可後再安裝：Windows（使用 WSL 2，需要重新啟動 Windows）與 macOS 上安裝 Docker Desktop，Linux 上安裝 Docker Engine。如果 Docker 沒有在執行，它會啟動 Docker。
2. 寫入 docker-compose.yml 到你主資料夾中的 mytickrs-docker 資料夾，然後下載映像檔並啟動。若要使用其他資料夾，請在執行前設定 MYTICKRS_DIR。
3. 在瀏覽器中開啟應用程式，網址為 http://localhost:5050。若要使用其他連接埠，請在執行前設定 MYTICKRS_PORT。

之後應用程式會隨 Docker 一起啟動。你的資料（資料庫，以及用來加密已儲存提供者金鑰的金鑰）存在 mytickrs-docker 內的 data 資料夾；要備份，請停止應用程式並複製該資料夾。要更新，再執行一次那一行指令即可，資料會保留。在 mytickrs-docker 資料夾中，docker compose stop 和 docker compose start 用來停止與啟動，docker compose down -v 用來移除。你的資料會一直留在 data 資料夾，直到你刪除它。

已經在用 Docker？在一個空資料夾中：

curl -fsSLO https://files.mytickrs.app/docker-compose.yml
docker compose up -d

3. 從原始碼執行

程式碼在 GitHub 上。使用 Node.js 24：

git clone https://github.com/myTickrs/myTickrs.git mytickrs
cd mytickrs
npm i
npm start

在沒有 Visual Studio C++ 工具的 Windows 上，請使用 npm i --ignore-scripts。

免費取得更新的價格

預設從 Yahoo Finance 取得價格，不需要金鑰。它是非官方來源，可能有落後，因此價格可能有延遲。若想要更新的報價，請在 Finnhub（最新報價與代號搜尋）和 Twelve Data（每日歷史、股票分割與股利）註冊免費帳號，並在設定 → 資料提供者中加入金鑰。你的金鑰會在你的電腦上加密。

從其他裝置使用

桌面版沒有登入功能：任何能連到它的人都能使用。除非你在 .env 中修改 HOST，否則它只在你自己的電腦上（127.0.0.1）監聽（在 Docker 中，是 docker-compose.yml 旁邊的 .env 裡的 MYTICKRS_BIND=0.0.0.0）。只有在你信任的網路上，或在有自己登入機制的反向代理後面，才這樣做。