← 返回使用說明
即時喚醒

用 Redis 讓資料反應更快(選用)

策略使用的外部資料預設以 **定期查詢** 取得。接上 Redis 後,新值寫入的瞬間代理程式就會被喚醒並立即重新讀取。 數值本身一律來自資料庫查詢 — Redis 上傳遞的只是「有新值進來了」的訊號。

首先:不做也沒關係 — 沒有 Redis,資料一樣正確,差別只在延遲。若是日K或小時K指標,定期查詢就足夠;只有需要在秒級反應的策略才需要這份文件。即使漏掉訊號,下一次定期查詢也會跟上。

1. 我的架構屬於哪一種

發布端(收集器)與訂閱端(代理程式)必須能連到同一個 Redis。只要符合這個條件,任何方式都可以。

A

全部在一台上 — 自行安裝(最簡單、免費)

如果收集器與代理程式在同一台伺服器上,在那台伺服器安裝 Redis 就完成了。不經過網路,所以最快,位址也不會離開這台機器。 預設設定已經只監聽 127.0.0.1,所以即使不設密碼也不會對外開放。

sudo apt install -y redis-server
sudo systemctl enable --now redis-server
redis-cli ping        # PONG
填入插槽的位址:redis://127.0.0.1:6379
B

我有多台伺服器 — 架在一台上,走私有網路

如果收集器與代理程式在不同的伺服器上,只在其中一台架設 Redis,其餘連過去即可。在同一雲端、同一區域內,用私有網路 IP 連線最安全。 ★ 若 bind 開放為 0.0.0.0 又不設密碼,很快就會被網際網路掃描器找到。若一定要走公開網路,請同時設定三項:長密碼 + 防火牆 + TLS(rediss://)。

# /etc/redis/redis.conf
bind 10.0.0.5 127.0.0.1      # ★ 0.0.0.0 금지
requirepass <긴-무작위-비밀번호>
# 방화벽: 내 서버 IP 만 6379 허용
填入插槽的位址:redis://:비밀번호@10.0.0.5:6379
C

網路是分開的 — 託管免費方案

如果收集器與代理程式位於不同雲端、家裡、公司等彼此連不到的地方,就在中間放一個託管 Redis。喚醒幾乎不占儲存空間,免費額度通常就夠用。

填入插槽的位址:rediss://…
2026年9月確認 — 供應商可能調整額度,請透過連結再次確認。
Upstash256MB · 월 50만 명령不需信用卡即可開始。即使每分鐘發布一次,每月也只有 4萬~5萬個命令,餘裕很大。不過同時連線上限未公開,且 SUBSCRIBE 只能透過 TCP(redis://) 位址使用,不能用 REST。
Aiven1GB · 단일 노드以 Valkey(相容 Redis 的分支)為基礎。pub/sub 是核心功能,不影響喚醒用途。
Redis Cloud30MB容量看起來很小,但喚醒不使用儲存空間,所以 30MB 也沒關係。
D

由他人發布 — 團隊或機構直接推送

不一定要使用我們的收集器。只要符合頻道名稱與酬載規則,任何程式都能發布。 頻道為 sori:data:v1: 後接資料表名稱(不含 schema)。酬載只是游標提示,即使放入數值也不會被使用 — 被喚醒的一方會重新執行自己的查詢。

PUBLISH sori:data:v1:fear_greed '{"v":1,"last":1757462400000,"n":1}'

2. 開啟步驟 — 三個地方都對上才會開啟

只要缺少任何一項,就會 **在沒有錯誤的情況下** 以定期查詢運作。數值依然正確,只是延遲變長,所以很容易沒發現它根本沒開啟。

1

發布端 — 把位址告訴收集器

收集器在寫入新資料列後發布。若沒有位址,就略過發布,並在執行結果中註明。

# ~/soritrading-fetchers/.env
SORI_WAKE_REDIS_URL=redis://127.0.0.1:6379
2

訂閱端 — 在代理程式上儲存插槽

在網頁上輸入別名與位址後按 [確認連線],該裝置會立即回報是否真的連得上。 位址只儲存在該裝置的金鑰庫中 — 不會傳到伺服器,也不會留在日誌裡。

3

宣告 — 決定哪個資料表透過哪個插槽接收

在同一畫面下方的 [資料集宣告] 中把方式改為 redis,並填入插槽名稱與資料表名稱。 需要資料表名稱,是因為頻道名稱由資料表名稱產生。

mode: redis   ·   redisAlias: main   ·   tableName: fear_greed
確認是否已開啟 — 宣告旁的徽章顯示「即時 · Redis(別名)」就表示已開啟。若顯示「定期查詢」,缺少什麼的原因會直接寫在那裡。
須知
  • Redis 只是喚醒訊號。即使漏掉訊息(例如代理程式重新啟動期間),下一次定期查詢也會跟上,所以數值不會出錯。
  • 無伺服器供應商的 REST 端點無法訂閱。請填入以 redis:// 或 rediss:// 開頭的 TCP 位址。
  • 如果免費方案會中斷閒置連線,可能在不知不覺中只靠定期查詢運作。代理程式會偵測斷線並重新連線,但若經常斷線,代表該方案不適合這個用途。
  • 插槽名稱與資料庫別名是不同的命名空間。即使兩者都叫 'main',也指向不同的伺服器。
  • 連線位址只儲存在代理程式裝置上。我們的伺服器不在這條路徑上,無論儲存或讀取都不會收到位址。
  • 刪除插槽後,已開啟的訂閱會在下次重新連線時中斷。在那之前數值相同,只是延遲較短。