Sean's Note

Sean 的部落格, 記錄一些小教學、自己的經歷

https://blog.sean.taipei/

https://blog.sean.taipei/feed.xml (RSS订阅地址)

Robust UDP Challenge - 網路程式設計概論

<h1 id="recap">前情提要</h1> <p>這學期修習黃俊穎老師開設的網路程式設計概論（網程設），前半學期教了如何用 TCP 從簡單的 socket 應用，到實作較為複雜的 IRC 伺服器。</p> <p>這次第 12 周的實驗內容讓大家用兩週的時間，寫出能抵抗惡劣網路環境的 UDP 程式，完整傳送 1,000 個平均 16 KB 的檔案。</p> <h2 id="limit">實驗限制</h2> <p>這次評測端使用 <a href="https://man7.org/linux/man-pages/man8/tc-netem.8.html" target="_blank">tc-netem (8)</a> 製造出不穩定的網路環境，限制如下：</p> <ul> <li>封包有 40% 機率會遺失、10% 機率損毀</li> <li>延遲 50 ms - 150 ms</li> <li>網速上限 10 Mbps</li> <li>封包大小上限 1,500 bytes</li> </ul> <p>在這樣的環境下，如果不特別做處理，基本上是傳不了檔案的，也因此是考驗各組技術的地方。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/12/netem-ping.png" alt="使用 ping 測試的結果（封包來回需乘二）" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">使用 ping 測試的結果（封包來回需乘二）</td> </tr> </tbody> </table> <h2 id="init">最初的想法</h2> <p>在開始寫程式之前，當然是要先設計自己的通訊協定原型。原本規劃好了整套如何取得目錄、如何得知檔名及內容的協議，不過愈想愈覺得在這次的實驗中，分檔案慢慢傳反而沒效率。</p> <p>因此後來決定把寫好的協議及寫到一半的程式碼全部刪掉，從頭開始設計當成單一檔案傳輸的方法。</p> <h1 id="format">封包結構</h1> <p>實驗環境 MTU 只允許每個封包傳送至多 1,500 bytes 的內容，因此會需要切成不同區塊，本次設計的封包結構前 2 bytes 是區塊編號。<br /> 每個小封包扣掉 IP 層標頭的 20 bytes 及 UDP 層標頭的 8 bytes，再扣掉 2 bytes 的區塊編號後，共有 1,470 bytes 可供存放資料。</p> <p>在我的作法中，是先合併出一個大封包。大封包最前面的數字是總區塊數，後面接著 1,000 個數字是各檔案的尺寸，再來各檔案內容直接連接在後，以節省填充內容佔用的空間。</p> <p>也因為老師保證檔案大小在 32,000 bytes 以下，最極端的例子封包數也不會超過 22,000 個，因此只需要 2 bytes 的空間（-32768 ~ 32767）即可儲存。後面再接上所有檔案，合併後一個大封包總共約 16 MB 大小。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/12/udp-header.png" alt="本次定義的標頭檔" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">本次定義的標頭檔</td> </tr> </tbody> </table> <h1 id="logic">傳送邏輯</h1> <p>在相當穩定的環境下，我們可以只傳送不確認；在反應迅速的環境下，我們可以等收到確認封包再進行下一步；但在這次既慢又不穩的環境下，兩種做法效率都不會太好。</p> <p>因此我採用的方式是發送端自行估算在恰好頂到速度上限時，每隔多久可以發送一個封包。<br /> 而接收端確認的方式，則是定期告訴發送端目前順利收到哪些封包了。</p> <h2 id="sender">發送端詳細邏輯</h2> <p>對發送端來說，如果封包傳得太急，會踩到 10 Mbps 速率上限，導致緩衝區愈來愈長，封包需要排隊才能送出。<br /> 如果因此造成多餘的延遲，讓確認封包也塞在緩衝區，最終導致無謂的時間浪費和送出更多重複的區塊，因此我們要找出適當的發送頻率以達到最佳平衡。</p> <p>以我的實作來說，每個封包都是吃滿 1,500 bytes 上限，多數流量來自發送端，來自接收端的確認封包佔少數。<br /> 在撰寫本文之前，埋頭寫程式都沒去認真計算理論值，經過測試得出發送端大約需延遲 0.756 毫秒，恰好是碰到速率上限的甜蜜點。</p> <p>對於總共 16 MB 的檔案，為了符合最大傳輸上限 1,500 bytes 限制，分割後大約有 11,500 個區塊需要傳輸。<br /> 最開始接收端什麼都沒有，因此先全部都發送一輪（約需 8.5 秒），之後再透過接收端回傳的確認封包，看哪些區塊未順利送達，再次依序發送。</p> <p>理想狀況中，每輪需要發送的區塊數量減半，所需時間也跟著減半。不過加上考慮延遲後，大約第六七輪開始，確認封包會來不及回傳。</p> <h2 id="receiver">接收端詳細邏輯</h2> <p>發送確認封包的方式有許多不同做法，依筆者心中的效率簡單排序，由低到高大致為：</p> <ol> <li>收到每個區塊時，都單獨回傳確認（可能較差）</li> <li>收到數個區塊後，用一個封包，批量進行確認</li> <li>每隔一段時間，用多個封包，回傳伺服器的完整狀態</li> <li>每隔一段時間，用多個封包，回傳所有收過的區塊編號</li> <li>每隔一段時間，用一個封包，回傳新收到了哪些區塊</li> <li>每隔一段時間，用一個封包，以 bitset 回傳伺服器狀態（可能較佳）</li> </ol> <p>因此在最終的版本中，我是以 bitset 形式回傳接收端的狀態，每次只需要一個封包即可完成。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/12/status-bitset.png" alt="使用 bitset 儲存、傳送狀態" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">使用 bitset 儲存、傳送狀態</td> </tr> </tbody> </table> <p>有思考過在最後剩下不到 500 個未完成區塊的時候，或許直接回傳近期收到的區塊編號可以再更節省流量，不過感覺實作相對麻煩就作罷了。</p> <h1 id="delay">延遲詳細計算</h1> <p>已知條件為：</p> <ul> <li>每個封包 1,500 bytes</li> <li>速率上限 10 Mbps</li> <li>約有 40% 機率遺失封包、10% 機率損毀</li> </ul> <p>根據定義可以計算：<br /> <code class="language-plaintext highlighter-rouge">(封包大小 1,500 bytes) * (單位轉換 8 bit / byte) * (成功率 60%) = 平均封包大小 7,200 bits</code><br /> <code class="language-plaintext highlighter-rouge">(速度 10 Mbps) / (封包 7,200 bits) = 每秒可傳送 1,388.88 個封包</code><br /> <code class="language-plaintext highlighter-rouge">1 / (每秒 1,388.88 封包) = 每封包間隔 0.72 毫秒</code></p> <p>雖然理論值是這樣，不過因為 <code class="language-plaintext highlighter-rouge">tc-netem</code> 實作的關係，似乎 0.75 毫秒才是最佳延遲，實驗及試算了好久都不知道怎麼得出正確數字。</p>  <h1 id="compress">檔案壓縮</h1> <p>原先在 Discord 嘴砲說想直接用外部函式庫完成這次實驗，想說既然都讓老師把檔案亂度增加了，那應該是不需要玩壓縮的技巧。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/12/discord-compress.png" alt="於 Discord 詢問使用壓縮函式庫" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">於 Discord 詢問使用壓縮函式庫</td> </tr> </tbody> </table> <p>不過後來得知檔案內容只包含可視字元，轉換為 ASCII 是 <code class="language-plaintext highlighter-rouge">0x21</code> 到 <code class="language-plaintext highlighter-rouge">0x7E</code> 的區段，在每個 byte 中 256 種可能中只佔了 94 種。</p> <p>在此假設檔案亂度不低，也就是外部壓縮函式庫幫助有限，因此採用類似 <code class="language-plaintext highlighter-rouge">base64_decode()</code> 的方式將檔案從可視字元區段映射到整個空間。</p> <p>最簡單的做法當然是取消最前面固定為 0 的位元，只要透過簡單的位元運算，就讓每 8 個可視字元字映射到 7 bytes，節省 12.5% 空間。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/12/conv-table.png" alt="每 8 個可視字元可映射至 7 bytes" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">每 8 個可視字元可映射至 14 bytes</td> </tr> </tbody> </table> <p>經過計算後，發現可以透過運算，把每 17 個可視字元映射到 14 bytes，省下了 17.6% 的空間。而運算過程中，剛好勉強低於 <code class="language-plaintext highlighter-rouge">__int128</code> 的上限，實作起來不算複雜。</p> <p>如此讓每個封包 1,470 bytes 的內容實際可塞下 1,785 個可視字元，封包總數量減少到 9,500 個。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/12/compress-printable.png" alt="把每 17 個可視字元映射到 14 bytes" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">把每 17 個可視字元映射到 14 bytes</td> </tr> </tbody> </table> <p>在最極端狀況下，每個封包其實可以塞下 1,794 個可視字元：<br /> <code class="language-plaintext highlighter-rouge">(log(256) / log(94)) * 1470 = 1794</code><br /> 雖然可以省下 18.1% 的空間，不過實作起來會困難許多，因此沒有採用此方法。</p> <h1 id="speed-up">減少多餘等待時間</h1> <p>在經過分析後，發現原本的程式最前面將檔案合併成大封包，再分割成 9,500 個區塊的過程中，大約會耗費 500 毫秒的時間，因此改為邊切割邊發送第一輪封包。</p> <p>而接收端如果在結束前才一次寫入，會耗費大約 350 毫秒的時間，發現後改為判斷接收完一個檔案就寫入一次。</p> <p>另外由於評測的機制是發送端結束後，會強制關閉接收端並開始比對檔案。因此發送端不能太快結束，但太晚結束又會影響表現。<br /> 後來測試出接收端在剩下大約 5 - 10 個區塊未完成時，提前傳送關閉指令是較為折衷的作法。</p> <h1 id="dynamic-delay">動態調整發送間隔</h1> <p>為了進一步最佳化性能，在接收端回傳狀態封包時，也順便帶上當下的時間戳。<br /> 發送端可以用來計算單向的延遲，判斷緩衝區是否已被塞滿。</p> <p>原本有實作根據延遲時間自動調整間隔的功能，不過由於延遲是隨機在 50 - 150 毫秒之間飄動，事後證實效益不大。<br /> 後來改為使用理論值來計算發送間隔，可以達到較穩定的效果。</p> <h1 id="no-udp">沒用到 UDP 的玩法</h1> <p>從看到實驗限制後，就有想到或許可以透過指令列參數，利用側通道傳送資料，不過覺得做起來稍嫌麻煩，因此一直沒有動工。</p> <p>在正規作法進步到 13.08 秒，想不到可以怎麼繼續加速後，就決定來實作看看，完成後還真的得到比當時第一名還快 70 倍的破表分數。<br /> 雖然有股想要壓到 0.02 秒以下的衝動，不過畢竟初衷只是確認可行性，還是決定先就此打住。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/12/cmdline-rank.png" alt="當下計分板 0.18 秒成績" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">當下計分板 0.18 秒成績</td> </tr> </tbody> </table> <h2 id="judge">評測方式</h2> <p>評測平台會建立 <code class="language-plaintext highlighter-rouge">/sender_dir/</code> 及 <code class="language-plaintext highlighter-rouge">/receiver_dir/</code> 兩個資料夾，並將發送端及接收端的執行檔分別置於 <code class="language-plaintext highlighter-rouge">/sender_dir/sender_bin</code> 及 <code class="language-plaintext highlighter-rouge">/receiver_dir/receiver_bin</code>。<br /> 在 <code class="language-plaintext highlighter-rouge">/sender_dir/files/</code> 資料夾放有 1,000 個隨機檔案，執行結束後會檢查是否成功傳輸至 <code class="language-plaintext highlighter-rouge">/receiver_dir/files/</code> 資料夾。</p> <p>以發送端來說，先使用 <code class="language-plaintext highlighter-rouge">chroot("/sender_dir/")</code> 防止執行環境存取外部檔案後，再執行 <code class="language-plaintext highlighter-rouge">/sender_bin --read-from="/files" --send-to="localhost:4242"</code> 指令啟動。<br /> 接收端則是以 <code class="language-plaintext highlighter-rouge">chroot("/receiver_dir/")</code> 限制環境後，再執行 <code class="language-plaintext highlighter-rouge">/receiver_bin --listen-port="4242" --store-to="/files"</code> 指令，將透過 UDP 協定收到的封包儲存至 <code class="language-plaintext highlighter-rouge">/receiver_dir/files/</code>。</p> <p>本題是限制網路層的傳輸速度，應該有不少做法作法可以繞過，我只挑自己較為熟悉的一種來實作。</p> <h2 id="cmdline">cmdline 簡介</h2> <p>我是從 2021 年 4 月在調研 ldapsearch 資安漏洞時，翻閱原始碼而接觸到這件事的，不過後來發現因為有盡最大努力側面修補，攻擊雖然可行但時間點需要抓得很精確，因此後續不了了之。<br /> 知道 cmdline 這種玩法後一直覺得很酷，或許寫成一篇科普短文也還不錯，但這裡為了篇幅就只講重點。</p> <p>熟悉 Linux 的大家應該都用過 <code class="language-plaintext highlighter-rouge">ps aux</code> 指令，但知道其中實作方式的人可能不多。<br /> 在 Linux 系統根目錄底下有個特殊的 <code class="language-plaintext highlighter-rouge">/proc/</code> 資料夾，存放核心（kernel）的相關資訊，而底下以程序編號（Process ID）命名的資料夾則存放各程序的狀態。<br /> 例如 <code class="language-plaintext highlighter-rouge">/proc/[PID]/fd/</code> 底下以數字命名的檔案，會連結（symbolic link）到程式開啟的各個檔案；而 <code class="language-plaintext highlighter-rouge">/proc/[PID]/cmdline</code> 檔案則寫著被執行時的參數，以 <code class="language-plaintext highlighter-rouge">0x00 (NUL)</code> 字元區隔。</p> <p>這個 cmdline 檔案雖然無法直接修改，但程式可以透過 <code class="language-plaintext highlighter-rouge">prctl()</code>、<code class="language-plaintext highlighter-rouge">pthread_setname_np()</code> 更動，或直接修改 <code class="language-plaintext highlighter-rouge">main()</code> 函式收到的 <code class="language-plaintext highlighter-rouge">char *argv[]</code> 內容也會反映在上面。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/12/ps-cmdline.png?" alt="透過 cmdline 查看指令參數" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">透過 cmdline 查看指令參數</td> </tr> </tbody> </table> <h2 id="side-channel">作法說明</h2> <p>在通常狀況下，<code class="language-plaintext highlighter-rouge">main()</code> 收到的 <code class="language-plaintext highlighter-rouge">char *argv[]</code> 長度也就幾十、至多幾百個字，如果要拿來傳資料顯然效率不足。<br /> 這時可以透過上面提過的函式更動，不過在此為了簡單實作，採用之前學過的 <code class="language-plaintext highlighter-rouge">exec()</code> 呼叫自己，並在 <code class="language-plaintext highlighter-rouge">argv[1]</code> 傳遞一個很長很長的參數，目的是擴充 <code class="language-plaintext highlighter-rouge">cmdline</code> 檔案大小，才塞得下整個檔案內容。</p> <p>在完成後就能自由運用 <code class="language-plaintext highlighter-rouge">argv[1]</code> 參數了，開始每隔 0.1 毫秒更新一次 <code class="language-plaintext highlighter-rouge">argv[1]</code>，依序將檔案內容放上。這會同步到 <code class="language-plaintext highlighter-rouge">/proc/[PID]/cmdline</code>，也就是 <code class="language-plaintext highlighter-rouge">ps aux</code> 指令會看到的結果。</p> <p>而接收端則是先等候一小段時間，先確保傳送端已啟動後，持續檢查位於 <code class="language-plaintext highlighter-rouge">/proc/[PID]/cmdline</code> 檔案的參數內容，如果有異動就寫入 <code class="language-plaintext highlighter-rouge">/receiver_bin/files/[ID]</code> 目標檔案。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/12/argv-cmdline.png" alt="使用 argv / cmdline 繞過限制傳送" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">使用 argv / cmdline 繞過限制傳送</td> </tr> </tbody> </table> <p>使用這個方法，理論上可以再 <code class="language-plaintext highlighter-rouge">fork()</code> 出不同程序（process）同步執行，用到本題上限的 15 個程序可以加速不少。</p> <p>也可以把間隔時間依照檔案大小自動調整，或是讓接收端發出訊號，減少不必要的等待時間。</p> <h1 id="epilogue">後記</h1> <p>寫這個實驗的過程中，心中一直被「執行效能」的想法所侷限，但仔細思考後認知到在這個場景下，最珍貴的資源是網路而不是 CPU 效能，有許多顯然花費不合理運算的事情實際上卻可以增進執行效率。</p> <p>老師在隔週的課堂也說了，原先沒想到大家會把時間用在最佳化上面，因此乾脆將一堂實驗課讓出來，給同學們分享各自作法的機會。<br /> 雖然有做好 <a href="https://hackmd.io/@Sean64/netprog-udp" target="_blank">簡報</a>，不過由於剛好要 <a href="/2022/01/ceh" target="_blank">參與資安檢測</a>，當周課堂無法出席報告，經過老師同意只好以 <a href="https://youtu.be/fY5yiRY0N6k" target="_blank">預錄影片</a> 代替。</p> <p>感謝 <a href="https://thect.cc/" target="_blank">Thect</a>、 <a href="https://imych.one/" target="_blank">yc油成</a>、 <a href="https://jerry.tw/" target="_blank">Jerry Hsu</a>、 <a href="https://github.com/andy89923" target="_blank">CTFang</a>、 <a href="https://siriuskoan.one/" target="_blank">Sirius Koan</a>、 <a href="https://blog.twinklestar03.com/" target="_blank">TwinkleStar03</a> 等朋友協助審閱文章提供建議，指出盲點讓文意更通順。<br /> 對於文章有任何想法，都歡迎來 <a href="https://twitter.com/Sea_n64/status/1603240158937387008" target="_blank">Twitter</a>、 <a href="https://facebook.com/Sean0604/posts/3366877213584114" target="_blank">Facebook</a> 留言交流，或是在課堂實體捕捉我。</p> <p>如果想嘗試的朋友，老師也在課後將 <a href="https://zoolab-org.github.io/lab_robust_udp/">實驗題目規格</a> 公開，歡迎參考練習。</p> <style> .post table td { color: #666; } .post table td a { color: #6bf; } .post table td a:hover, .post table td a:active, .post table td a:focus { color: #8cf; } </style>

2022/12/15

交大資工所推甄紀錄韋詠祥

<h1 id="tldr">TL;DR</h1> <p>今年申請交大資工的丙組、丁組，由於時程因素，只做了下圖 2 頁的自傳 + 讀書計畫：</p> <table> <thead> <tr> <th style="text-align: center"><a href="https://img.sean.taipei/2022/11/nctu.pdf" target="_blank"><img src="https://img.sean.taipei/2022/11/nctu.png" alt="韋詠祥交大資工所推甄自傳縮圖" /></a></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">交大資工所推甄自傳<br /><a href="https://img.sean.taipei/2022/11/nctu.pdf">https://img.sean.taipei/2022/11/nctu.pdf</a></td> </tr> </tbody> </table> <p>丙丁組皆在資料審查階段就獲得直接錄取，目前已於丁組（系計中）報到。</p> <h1 id="why-nctu">為何只投交大</h1> <p>對部分資工系學生而言，研究所的順位或許是國外 > 台大 > 交清 > 其他學校，但在我的觀點中並非如此。</p> <p>由於想留在台灣，現階段較不考慮出國攻讀研究所。<br /> 某些人會宣稱台大資源比交大豐富，但在資訊安全及實作領域，交大或許勝過台大。<br /> 有朋友同時申請交大及清大，但兩者錄取的門檻差不多，如果都上了我只會選交大，因此就不去佔名額浪費資源了。</p> <p>而且與交大相關領域的教授都相對熟識，直升對我而言是個最好的選擇。<br /> 因此在我心中順位是交大 > 台大 > 清大 > 國外研究所。</p> <h1 id="nctu-cs">交大資工研究所組別簡介</h1> <p>交大資工共分為 4 個所，分別是：</p> <ul> <li>資科工所（資訊科學與工程研究所）</li> <li>網工所（網路工程研究所）/ 推甄收 30 人</li> <li>多媒所（多媒體工程研究所）/ 推甄收 27 人</li> <li>數據所（數據科學與工程研究所）/ 推甄收 34 人</li> </ul> <p>其中資科工所又再分為 4 個組：</p> <ul> <li>甲組 / 推甄收 87 人</li> <li>丙組（實作導向）/ 推甄收 15 人</li> <li>丁組（系統與網路管理實務，系計中）/ 推甄收 6 人</li> <li>戊組（校務資訊系統技術與實務，校計中）/ 推甄收 7 人</li> </ul> <p>另外資訊學院底下，還有個資安學程（資通安全碩士學位學程），前稱資電亥客。</p> <p>各組別之間主要差異是：</p> <ul> <li>可以找的 <a href="https://www.cs.nycu.edu.tw/education/master/advisor" target="_blank">教授名單</a> 不同、名額分開計算</li> <li>畢業標準、必修課程不同</li> <li>審查注重的面向不同</li> <li>丙丁戊組通過初步書審後，需個別面試</li> <li>丁組需負責開發資工系服務、戊組需協助維護交大校務系統</li> </ul> <h1 id="journal">申請過程</h1> <p>通常比較認真的學生都會提前半年一年開始準備，而我雖然一直把這件事放在待辦清單，但由於出現其他更重要的事務，拖到最後一刻才處理。</p> <p>上了大學之後，雖然持續有在參加各領域活動，但沒有動機整理自身經歷，連獎狀都是散落在三四個不同地方。<br /> 九月剛 <a href="/2022/09/icann-zh" target="_blank">出國參與 ICANN 會議</a> 回來，10/6（四）又受邀擔任座談會與談人，因此 10/7（五）才開始準備資料，共有 5 天可以處理。</p> <p>第一天 10/7（五）先去行事曆、信箱、雲端硬碟到處翻，回顧大學階段做了哪些事，並將主要的經歷放上網站。<br /> 個人網站的部分，從國中之後就沒什麼動過了，趁這次機會跟 <a href="https://imych.one/" target="_blank">@yc97463</a> 借用版面設計來更新。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/11/sean-2016.png" alt="最初的模樣" /></th> <th style="text-align: center"><img src="https://img.sean.taipei/2022/11/sean-2022.png" alt="修改前" /></th> <th style="text-align: center"><img src="https://img.sean.taipei/2022/11/sean-now.png" alt="更新後" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">最初的模樣（<a href="https://web.archive.org/web/20160412001622/https://sean.taipei/" target="_blank">2016 年</a>）</td> <td style="text-align: center">修改前（<a href="https://web.archive.org/web/20220923135224/https://www.sean.taipei/" target="_blank">2022 年</a>）</td> <td style="text-align: center">更新後（<a href="https://web.archive.org/web/20221118044803/https://www.sean.taipei/" target="_blank">現在</a>）</td> </tr> </tbody> </table> <p>第二天 10/8（六）開始研究推甄相關規則、需求，並初步填寫系統上的資料。</p> <p>第三天 10/9（日）製作自傳、讀書計畫時，由於知道教授們時間寶貴，決定這次將審查資料濃縮在 2 頁 PDF 內解決。</p> <p>對於版面設計不在行的我，突然想到平常用的 Markdown 很符合資工人的日常，或許可以在維持可讀性的同時又增添一點設計感，因此用 macOS 內建的 Pages 手刻出相似樣式。</p> <p>完成自傳草稿後，也寄信給四位師長，詢問是否願意協助撰寫推薦函。<br /> 雖然覺得資料不齊全就開口詢問老師們有點不尊重，但礙於時程不先給出半成品也不是辦法，只能各處都先做到基本分再求精進。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/11/nctu-letter-ask.jpg" alt="詢問教授撰寫推薦函" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">詢問教授撰寫推薦函</td> </tr> </tbody> </table> <p>第四天 10/10（一）國慶連假，先研究了推薦函如何填覆、有哪些欄位，整理時程資訊，再翻找信件往來紀錄、聊天記錄，列出與推薦人相關的事件供四位推薦人參考。</p> <p>這次推薦人找了兩位交大資工系上的老師、一位科法所的老師、一位網路治理及安全領域德高望重的前輩。<br /> 很感激四位師長願意用自己寶貴的時間，替我撰寫推薦函、為我的能力背書。</p> <p>第五天 10/11（二）17:00 報名截止，去投幣列印了歷年成績單，整理申請表將報名資料繳交至教務處。<br /> 由於時間不足，系統上競賽成績、開發經驗、其他有利資料等欄位都只能留空。</p> <h1 id="application">填覆資料</h1> <p>交大資工所的招生申請系統中，共有 50+ 個欄位需要填寫，以下是本次主要欄位資料。</p> <h2 id="application-rank">總名次及修業學分</h2> <p>歷年平均：81.3 分<br /> 系排名：62%（123 名 / 共 199 人）<br /> 已修習：136 學分（6 學期平均 23 學分）<br /> 不及格：12 學分（微積分 4 學分 * 3 門）</p> <h2 id="application-overview">修課狀況自評</h2> <p>總體而言數學及英文科目分數較差，而資訊科目應對起來較為輕鬆，尤其實務導向課程表現較為亮眼。</p> <p>由於同時忙於系計中、資訊社群、資安競賽、開源貢獻、網路治理等領域，無法兼顧成績表現，僅能維持平均水準。</p> <h2 id="application-best">修習電資領域專業課程「最佳」表現</h2> <p>計算機系統管理：95 分<br /> 計算機網路管理：99 分<br /> 網路規劃與管理實務：99 分<br /> 演算法概論：94 分<br /> （研）全球網路治理：95 分<br /> 組合語言與系統程式：97 分</p> <p>其中 NA、SA、組語為大一修習。</p> <h2 id="application-worst">修習電資領域專業課程「最差」表現</h2> <p>線性代數：75 分<br /> 機率：67 分<br /> 密碼學概論：69 分<br /> 計算機組織：75 分<br /> （研）程式安全：71 分</p> <p>數學佔比高的科目表現較差，僅能滿足基本需求。部分資工課程於期末時因外務繁忙而難以兼顧成績。</p> <h1 id="result">申請結果</h1> <p>這次我只申請丙組、丁組，皆由於第一階段書面審查分數較高，教授們決議跳過面試提供逕取（直接錄取）資格。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/11/score-201.png" alt="丙組成績單" /></th> <th style="text-align: center"><img src="https://img.sean.taipei/2022/11/score-202.png" alt="丁組成績單" /></th> <th style="text-align: center"><img src="https://img.sean.taipei/2022/11/nctu-result.jpg" alt="丙組丁組皆得到直接錄取" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">丙組成績單</td> <td style="text-align: center">丁組成績單</td> <td style="text-align: center">兩組皆得到直接錄取<br />（來源：<a href="https://exam.nycu.edu.tw/bulletin2.aspx?id=14048c8a-d1ca-465d-a603-1b5795e1f1da&id2=930cd74c-95ed-45bb-980f-f636b42230eb" target="_blank">交大碩班推甄榜單</a>）</td> </tr> </tbody> </table> <p>目前已完成丁組報到，並放棄丙組資格讓其他考生得以儘速遞補，畢業後碩班將繼續留在系計中服務。</p> <h1 id="epilogue">後記</h1> <p>幾年前聽到丁組的名聲其實不太好，甚至聽過有人比喻為用勞力換學歷，某些人為了畢業不是很順利。</p> <p>但從我加入系計中兩年多來，有許多事物漸漸在改變，也有愈來愈多人才加入丁組，整體氣氛相當融洽。<br /> 甚至去年 <a href="https://www.libralight.dev/" target="_blank">Leo Chen</a> 及 <a href="https://xdavidwu.link/about/" target="_blank">David Wu</a> 兩位系上技術頂尖的強者從大學時就在系計中服務，畢業後也以丁組作為第一志願，讓我在審慎思考過後決定留在丁組繼續與大家打拼。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/11/cc-sitcon.jpg" alt="同學自發於 SITCON 閃電秀分享" /></th> <th style="text-align: center"><img src="https://img.sean.taipei/2022/11/cc-gmaps.jpg" alt="助教休息空間鯊滿為患" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">同學自發於 SITCON 閃電秀分享<br />（圖源：<a href="https://www.flickr.com/photos/sitcon/52366050249/in/album-72177720302195888/" target="_blank">SITCON Flickr</a>）</td> <td style="text-align: center">助教休息空間鯊滿為患<br />（圖源：<a href="https://goo.gl/maps/Q4TsM1G1Vh67zzhu8" target="_blank">Google Maps</a>）</td> </tr> </tbody> </table> <p>本文同步分享於 <a href="https://t.me/SeanChannel/107" target="_blank">Telegram</a>、 <a href="https://twitter.com/Sea_n64/status/1596804193339158529" target="_blank">Twitter</a>、 <a href="https://www.facebook.com/Sean0604/posts/3350524638552705" target="_blank">Facebook</a>，礙於文章篇幅，如果有什麼好奇的、想暸解更多的點，都歡迎來留言區交流。</p> <h1 id="reference">參考連結</h1> <ul> <li><a href="https://coder.tw/?p=7761" target="_blank">丁組推甄心得 + QA</a>（2021 年 9 月）</li> <li><a href="https://it.cs.nycu.edu.tw/join-us" target="_blank">交大資工系計中加入我們</a></li> <li><a href="https://tg.pe/lv5in" target="_blank">丁戊組推甄心得 + 考古題</a>（2021 年 9 月）</li> <li><a href="https://www.ptt.cc/bbs/graduate/M.1585660982.A.56F.html" target="_blank">丁戊組推甄心得</a>（2020 年 3 月）</li> <li><a href="https://blog.sean.taipei/2019/08/nctu" target="_blank">大學個人申請備審資料擴散紀錄</a>（2019 年 8 月）</li> </ul> <style> .post h2 { margin: -6px 0 4px 0; } .post table td { color: #666; } .post table td a { color: #6bf; } .post table td a:hover, .post table td a:active, .post table td a:focus { color: #8cf; } </style>

2022/11/27

ICANN75 - 吉隆坡之旅

<p>很高興這次能在 NII 舉辦的「ICANN 公共政策研習營」獲選為優良學員，受邀參與位於馬來西亞吉隆坡的 ICANN75 年度會議，並提供旅費補助。</p> <p><strong>Note:</strong> There’s also a <a href="https://blog.sean.taipei/2022/09/icann-en">English version</a> of this post.</p> <h1 id="前情提要">前情提要</h1> <p>ICANN 是統籌分配管理全球 IP 位址及網域名稱的非營利組織，內部分為多個 Stackholder Group（利害關係人團體），由下而上的討論制定政策</p> <p>在台灣由 NII 每年舉辦兩場研習營，只要全程參與就能拿到數千元的獎學金，並且每年選出幾位優秀學員參與 APrIGF 及 ICANN 等國際會議。</p> <p>一個是 <a href="https://igcamp.tw/" target="_blank">網路治理研習營</a>，分為網路安全、平台規範、數位人權三組，探討多個相關議題。<br /> 今年我被邀請於閉幕時 <a href="https://hackmd.io/@Sean64/igcamp-2022" target="_blank">分享參與經驗</a>，並獲選為優良實習學員，以中文撰寫 <a href="https://igwatch.tw/2022/07/29/%E2" target="_blank">三篇</a> <a href="https://igwatch.tw/2022/08/08/%E2" target="_blank">會議</a> <a href="https://igwatch.tw/2022/08/23/%E8" target="_blank">摘要</a>。</p> <p>另一個則是 <a href="https://dnslearn.tw/icanncamp-home" target="_blank">ICANN 公共政策研習營</a>，透過扮演 GAC 政府代表、ALAC 群眾代表、GNSO 網域代表，針對頂級域名相關議題，分組討論組內的觀點，再於模擬會議上凝聚全體共識。<br /> 這次我順利獲選為優秀學員，並得到旅費、住宿、防疫旅館、生活費等全額補助，前往吉隆坡參與 ICANN75 大會。</p> <table> <thead> <tr> <th><img src="https://img.sean.taipei/2022/09/icann-twcamp-discuss.jpg" alt="" /></th> <th><img src="https://img.sean.taipei/2022/09/icann-twcamp-group.jpg" alt="" /></th> </tr> </thead> <tbody> <tr> <td>分為各個 Stackholder Group 討論</td> <td>ICANN 公共政策研習營合照</td> </tr> </tbody> </table> <h1 id="旅程規劃">旅程規劃</h1> <p>由於 NII 核銷規定，只能訂購指定日期的航班，無法自費在當地多留個幾天。<br /> 再加上來回確認延誤了訂購時程，只剩沒多少航班可供挑選了。</p> <p>因此我選擇在週六晚上到新加坡轉機，隔天早上再飛馬來西亞。也因為這個晚上轉機的時間，讓我能參訪新加坡樟宜國際機場的多處美景。</p> <table> <thead> <tr> <th><img src="https://img.sean.taipei/2022/09/icann-sgp.jpg" alt="" /></th> <th><img src="https://img.sean.taipei/2022/09/icann-badge.jpg" alt="" /></th> </tr> </thead> <tbody> <tr> <td>晚上逛新加坡樟宜國際機場</td> <td>順利報到，取得 ICANN75 名牌</td> </tr> </tbody> </table> <p>接著週一、週二、週三，整天都在參加 ICANN75 會議，其中有 6 個場次是合約中指定的，剩下的讓我自由挑選。</p> <p>回程航班訂在週四下午，也因此無緣參與最後一天的 Public Forum 等議程。</p> <table> <thead> <tr> <th><img src="https://img.sean.taipei/2022/09/icann-apralo.jpg" alt="" /></th> <th><img src="https://img.sean.taipei/2022/09/icann-apac-room.jpg" alt="" /></th> </tr> </thead> <tbody> <tr> <td>參與 ICANN75 APRALO 議程<br />（圖源：<a href="https://www.flickr.com/photos/icann/52371358028/in/album-72177720302230206/" target="_blank">ICANN Flickr</a>）</td> <td>參與 ICANN75 APAC Space 議程<br />（圖源：<a href="https://twitter.com/ICANN/status/1572143906497921024/" target="_blank">ICANN Twitter</a>）</td> </tr> </tbody> </table> <h1 id="認識新朋友">認識新朋友</h1> <p>第一天抵達 KLCC（吉隆坡會議中心，Kuala Lumpur Convention Centre）時，NII 的理旋跟我說可以去參與 NextGen 議程，認識一下與我同年的小朋友們。</p> <p>在 ICANN75 會場遇到的所有人都相當的友善，我只是靠近聽他們在聊些什麼，就直接叫我名字（應該是看名牌）跟我打招呼，並歡迎我加入對話。</p> <p>前兩天由於時間因素，沒能跟 NextGen 計劃的夥伴們一起吃晚餐，讓我覺得非常失落。</p> <p>而在週三晚上，我們約去中國城逛街，再到 Jalan Alor 美食街一起吃泰式料理。</p> <table> <thead> <tr> <th><img src="https://img.sean.taipei/2022/09/icann-china.jpg" alt="" /></th> <th><img src="https://img.sean.taipei/2022/09/icann-dinner.jpg" alt="" /></th> </tr> </thead> <tbody> <tr> <td>吉隆坡中國城</td> <td>共享泰式料理</td> </tr> </tbody> </table> <p>我們 5 人之中，沒有人的母語是英文，但他們都非常包容我一直打結的英文。</p> <p>來自馬來西亞的 Adlin 送了在地的精品巧克力、<br /> 來自柬埔寨 Somaly 送了我吳哥窟鑰匙圈、<br /> Phyo 送我緬甸當地的糖果。</p> <p>沒想到在 ICANN 會議期間會認識到這麼多好朋友，我很後悔沒有準備任何台灣紀念品。（甚至出國前把所有新台幣都換成了馬來西亞令吉）</p> <table> <thead> <tr> <th><img src="https://img.sean.taipei/2022/09/icann-adlin.jpg" alt="" /></th> <th><img src="https://img.sean.taipei/2022/09/icann-somaly.jpg" alt="" /></th> </tr> </thead> <tbody> <tr> <td>來自馬來西亞的 Adlin</td> <td>來自柬埔寨的 Somaly</td> </tr> </tbody> </table> <h1 id="結語">結語</h1> <p>我真的很榮幸能有機會去吉隆坡與來自各地的朋友交流，未來將繼續深入研究 ICANN 政策及網路治理，希望有天能成為 ICANN Fellow，再次見到令我感動的大家。</p> <table> <thead> <tr> <th><img src="https://img.sean.taipei/2022/09/icann-group-afternoon.jpg" alt="" /></th> <th><img src="https://img.sean.taipei/2022/09/icann-apac-group.jpg" alt="" /></th> </tr> </thead> <tbody> <tr> <td>點心休息時間</td> <td>APAC 團體照<br />（圖源：<a href="https://www.flickr.com/photos/icann/52373019221/in/album-72177720302230206/" target="_blank">ICANN Flickr</a>）</td> </tr> </tbody> </table> <p>本文同步分享於 <a href="https://twitter.com/Sea_n64/status/1573288741724196865" target="_blank">Twitter</a>、 <a href="https://www.facebook.com/Sean0604/posts/3292442171027619" target="_blank">Facebook</a>，如果有什麼想法，都歡迎來留言區交流。</p> <h1 id="相關連結">相關連結</h1> <ul> <li>本文 <a href="https://blog.sean.taipei/2022/09/icann-en">英文版</a></li> <li><a href="https://75.schedule.icann.org/agenda" target="_blank">ICANN75 議程表</a></li> <li>ICANN 官方 <a href="https://www.flickr.com/photos/icann/albums" target="_blank">Flickr 相簿</a></li> <li><a href="https://www.twnic.tw/mps/page10.html" target="_blank">ICANN 多方利害關係人模式</a>（TWNIC 中文版介紹）</li> </ul> <style> .post table td { color: #666; } .post table td a { color: #6bf; } .post table td a:hover, .post table td a:active, .post table td a:focus { color: #8cf; } </style>

2022/9/23

ICANN75 - Trip to Kuala Lumpur

<p>I’m glad that I got the opportunity to be selected by NII program to attend the ICANN75 Annual General Meeting in Kuala Lumpur, Malaysia.</p> <p><strong>Note:</strong> There’s also a <a href="https://blog.sean.taipei/2022/09/icann-zh">Chinese version</a> for my Taiwanese friends.<br /> 這篇文是寫給在吉隆坡認識的好朋友們，歡迎台灣朋友左轉 <a href="https://blog.sean.taipei/2022/09/icann-zh">中文版</a> 文章。</p> <h1 id="why-i-can-attend-icann75">Why I can attend ICANN75</h1> <p>NII hosts two study camps in Taiwan every year. It provides scholarships for all attendees who finished the course, and selects a few students to attend international conferences like APrIGF and ICANN meetings.</p> <p>The first one is called <a href="https://igcamp.tw/" target="_blank">Internet Governance Camp</a>, in which we discuss various issues. This year I was selected as a Intern Student, and had written <a href="https://igwatch.tw/2022/07/29/%E2" target="_blank">three</a> <a href="https://igwatch.tw/2022/08/08/%E2" target="_blank">meeting</a> <a href="https://igwatch.tw/2022/08/23/%E8" target="_blank">summaries</a> in Chinese.</p> <p>Another is <a href="https://dnslearn.tw/icanncamp-home" target="_blank">ICANN Public Policy Camp</a>, I was rated as one of the best students during a simulation meeting about closed generic TLD, which provides the financial aid to attend ICANN75 and the chance to make friends here.</p> <table> <thead> <tr> <th><img src="https://img.sean.taipei/2022/09/icann-twcamp-discuss.jpg" alt="" /></th> <th><img src="https://img.sean.taipei/2022/09/icann-twcamp-group.jpg" alt="" /></th> </tr> </thead> <tbody> <tr> <td>Discussing as Stackholder Groups</td> <td>ICANN Camp in Taiwan</td> </tr> </tbody> </table> <h1 id="flight-schedule">Flight Schedule</h1> <p>I have to arrive and depart on a specific date limited by the NII contract, which means that I cannot stay longer in Malaysia at my own expense.<br /> Also since I booked my ticket too late, there are not a lot of options to choose from.</p> <p>I flew from Taiwan to Singapore on Saturday evening, stayed the night at Singapore airport, then flew to Malaysia on Sunday morning.</p> <table> <thead> <tr> <th><img src="https://img.sean.taipei/2022/09/icann-sgp.jpg" alt="" /></th> <th><img src="https://img.sean.taipei/2022/09/icann-badge.jpg" alt="" /></th> </tr> </thead> <tbody> <tr> <td>Stay at Singapore Changi airport</td> <td>Got my ICANN75 badge</td> </tr> </tbody> </table> <p>I attended the ICANN75 session from Monday to Wednesday. This scholarship program has specified 6 mandatory sessions to attend, and the rest is up to me.</p> <p>My return flight to Taiwan is on Thursday afternoon, so I don’t have the chance to attend the last day of ICANN75 such as Public Forum.</p> <table> <thead> <tr> <th><img src="https://img.sean.taipei/2022/09/icann-apralo.jpg" alt="" /></th> <th><img src="https://img.sean.taipei/2022/09/icann-apac-room.jpg" alt="" /></th> </tr> </thead> <tbody> <tr> <td>Attending ICANN75 APRALO session<br />(Source: <a href="https://www.flickr.com/photos/icann/52371358028/in/album-72177720302230206/" target="_blank">ICANN Flickr</a>)</td> <td>Attending ICANN75 APAC Space session<br />(Source: <a href="https://twitter.com/ICANN/status/1572143906497921024/" target="_blank">ICANN Twitter</a>)</td> </tr> </tbody> </table> <h1 id="friends">Friends</h1> <p>The first day I arrived at KLCC (Kuala Lumpur Convention Centre), Sophie from NII told me I can make some friends from NextGen, those who are at the same age as me.</p> <p>All people at ICANN75 meeting are so kind. When I approach them and listen to what they are talking about, most people will call my name (on the badge) and greet with me.</p> <p>But sadly, I missed their invitations for dinner for the first two nights. It’s a shame that I couldn’t spend more time with them.</p> <p>The Wednesday night, we went to chinatown for shopping and having Thai food at Jalan Alor Food Street together.</p> <table> <thead> <tr> <th><img src="https://img.sean.taipei/2022/09/icann-china.jpg" alt="" /></th> <th><img src="https://img.sean.taipei/2022/09/icann-dinner.jpg" alt="" /></th> </tr> </thead> <tbody> <tr> <td>China Town</td> <td>Thai food</td> </tr> </tbody> </table> <p>None of us speaks English as our native language, but they are all so inclusive for my unclear accent.</p> <p>Adlin from Malaysia gave me local refined Chocolate.<br /> Somaly gave me Angkor Wat keychain from Cambodia.<br /> Phyo gave me some Myanmar candies.</p> <p>I didn’t expect that I would make so many nice friends during ICANN meeting, I’m very regretful that I didn’t prepare any Taiwanese souvenirs. (I even exchanged all Taiwan dollar to Malaysia Ringgits)</p> <table> <thead> <tr> <th><img src="https://img.sean.taipei/2022/09/icann-adlin.jpg" alt="" /></th> <th><img src="https://img.sean.taipei/2022/09/icann-somaly.jpg" alt="" /></th> </tr> </thead> <tbody> <tr> <td>Adlin from Malaysia</td> <td>Somaly from Cambodia</td> </tr> </tbody> </table> <h1 id="ending">Ending</h1> <p>I’m really glad to be here and have the chance to talk with different people. I’ll keep digging into ICANN Policy and Internet Governance. And hope I can be ICANN fellow one day, to meet all the nice people again.</p> <table> <thead> <tr> <th><img src="https://img.sean.taipei/2022/09/icann-group-afternoon.jpg" alt="" /></th> <th><img src="https://img.sean.taipei/2022/09/icann-apac-group.jpg" alt="" /></th> </tr> </thead> <tbody> <tr> <td>Our tea break</td> <td>APAC Group Photo<br />(Source: <a href="https://www.flickr.com/photos/icann/52373019221/in/album-72177720302230206/" target="_blank">ICANN Flickr</a>)</td> </tr> </tbody> </table> <h1 id="links">Links</h1> <ul> <li><a href="https://blog.sean.taipei/2022/09/icann-zh">Chinese Version</a> of this post</li> <li><a href="https://75.schedule.icann.org/agenda" target="_blank">ICANN75 Agenda</a></li> <li>ICANN <a href="https://www.flickr.com/photos/icann/albums" target="_blank">Flickr Album</a></li> </ul> <style> .post table td { color: #666; } .post table td a { color: #6bf; } .post table td a:hover, .post table td a:active, .post table td a:focus { color: #8cf; } </style>

2022/9/23

Kubernetes 網站貢獻心得

<h1 id="prologue">前言</h1> <p>今年 4 月時，在讀文件的過程中發現了個小錯字，發 PR 後看到 Kubernetes GitHub 的完整流程覺得很酷，就開始參與社群、持續貢獻到現在了。</p> <p>在研讀完幾份貢獻者說明文件、實際參與過數百個 PR 後，來寫篇中文筆記介紹整套制度流程。</p> <p>本文將先快速帶過發 PR 後到 merge 經過的階段，接著解釋 <a href="#labels">標籤的意義</a>，最後統整 <a href="#roles">社群成員身份</a> 及晉升流程。</p> <h1 id="after-pr">發起 Pull Request 後會發生哪些事</h1> <p>在 Kubernetes 的專案中，大多是由 <code class="language-plaintext highlighter-rouge">@k8s-ci-robot</code> 負責各項自動化任務的，先來講講行為流程。</p> <p>在出現新的 Pull Request 時，根據改動的檔案加上不同標籤，例如：</p> <ul> <li>在 k/website 專案中，自動加上 <kbd>sig/docs</kbd></li> <li>如果更動的行數在 30 - 99 行，標示為 <kbd>size/M</kbd></li> <li>依照檔案所在的資料夾，加上語言 <kbd>language/zh</kbd> 標籤</li> <li>如果使用者有乖乖簽署貢獻者授權協議，加上必備的 <kbd>cncf-cla: yes</kbd> 標籤</li> </ul> <p>在加上標籤後，根據修改到的檔案隨機指派兩名 Reviewer，並告訴使用者在收到 <kbd>lgtm</kbd> 後該找哪位 Approver 協助。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/08/k8s-bot.jpg" alt="@k8s-ci-robot 為 PR 加上 label 分類" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center"><code class="language-plaintext highlighter-rouge">@k8s-ci-robot</code> 為 PR 加上 label 分類（<a href="https://github.com/kubernetes/website/pull/35700" target="_blank">k/website#35700</a>）</td> </tr> </tbody> </table> <p>過 10 分鐘後，輪到為每個 PR 建置預覽網站的 Netlify 機器人出場了，會留言告訴我們測試站的連結、失敗的話錯誤原因是什麼。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/08/k8s-netlify.jpg" alt="Netlify 機器人產生好預覽網站" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">Netlify 機器人產生好預覽網站（<a href="https://github.com/kubernetes/website/pull/35700" target="_blank">k/website#35700</a>）</td> </tr> </tbody> </table> <p>再來只要等搜集到 <kbd>lgtm</kbd> + <kbd>approved</kbd> 兩個標籤，並且沒有 <kbd>do-not-merge/hold</kbd>、<kbd>needs-rebase</kbd> 等負面標籤，就會被放進 Merge pool 中。</p> <p>在 Merge pool 中，為了避免衝突需要等待幾秒到幾分鐘的時間，排到隊後就會自動合併進去啦！</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/08/k8s-merge.jpg" alt="得到 lgtm 及 approved 後自動被合併" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">得到 lgtm 及 approved 後自動被合併（<a href="https://github.com/kubernetes/website/pull/34311" target="_blank">k/website#34311</a>）</td> </tr> </tbody> </table> <h1 id="labels">標籤的意義</h1> <p>前面快速帶過了整個 Pull Request 從發起到成功合併的流程，再來介紹一下數百個標籤中比較常用的幾個。</p> <h2 id="positive-labels">正向標籤</h2> <p><kbd>lgtm</kbd>，即 Looks good to me 的意思，任何 Kubernetes 組織成員都可以使用 <code class="language-plaintext highlighter-rouge">/lgtm</code> 指令加上此標籤。</p> <p>LGTM 標籤的意義是「這份程式碼改動看起來不錯」，因此只要檔案有更動，這個標籤就會消失，需要重新用 <code class="language-plaintext highlighter-rouge">/lgtm</code> 指令加回來。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/08/k8s-lgtm.jpg" alt="得到 lgtm 標籤後更動檔案" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">得到 lgtm 標籤後更動檔案（<a href="https://github.com/kubernetes/website/pull/35411" target="_blank">k/website#35411</a>）</td> </tr> </tbody> </table> <p><kbd>approved</kbd>，代表這個 PR 的大方向已被核可。</p> <p>每個檔案所屬的資料夾都有對應的 <code class="language-plaintext highlighter-rouge">OWNERS</code> 檔案，記錄著哪些檔案由哪些人擔任 Approver。機器人會確保 PR 修改到的每個檔案都有對應的 Approver 核可，才會加上這個標籤。</p> <p>跟 <kbd>lgtm</kbd> 不同的是，就算檔案被修改過，<kbd>approved</kbd> 標籤也不會消失。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/08/k8s-approve.jpg" alt="使用 approve 指令" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">使用 approve 指令（<a href="https://github.com/kubernetes/website/pull/35506" target="_blank">k/website#35506</a>）</td> </tr> </tbody> </table> <p><kbd>cncf-cla: yes</kbd> 是第三個不可或缺的標籤，在官方規則下，大家不該 review 沒有這標籤的 PR。</p> <p>為了確保免於未來潛在的法律爭議，大型專案通常都會要求貢獻者簽署 CLA 授權協議（Contributor License Agreement），只要照著指示一次性的簽署完畢就行了。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/08/k8s-cla.jpg" alt="CLA 貢獻者授權協議" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">CLA 貢獻者授權協議（<a href="https://github.com/kubernetes/website/pull/32897" target="_blank">k/website#32897</a>）</td> </tr> </tbody> </table> <h2 id="negative-labels">負面標籤</h2> <p>只要 PR 包含任一個負面標籤，就無法被自動合併。</p> <p>最常見的是，PR 作者與任何 Kubernetes 成員都可以使用的 <kbd>do-not-merge/hold</kbd>。</p> <p>當遇到根本性的錯誤，會用 <code class="language-plaintext highlighter-rouge">/hold</code> 來請作者特別注意，常見狀況是 git 操作錯誤，或動到不該動的檔案。</p> <p>也因為 PR 作者可以自己 <code class="language-plaintext highlighter-rouge">/unhold</code> 解除，有時也會被用來作為讓 PR 作者自行控制何時被 merge 的工具，像是最後再次確認有沒有小地方要修改，或是部落格文章希望在哪天發佈。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/08/k8s-hold.jpg" alt="被 hold 的實際狀況" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">被 hold 的實際狀況（<a href="https://github.com/kubernetes/website/pull/34722" target="_blank">k/website#34722</a>）</td> </tr> </tbody> </table> <p>在 commit 訊息中包含禁用關鍵字的話，則會出現 <kbd>do-not-merge/invalid-commit-message</kbd>。</p> <p>由於專案中已經有 <code class="language-plaintext highlighter-rouge">@k8s-ci-robot</code> 來做各種自動化事務了，為了避免意外發生，禁止在 commit 訊息中觸發原先 GitHub 提供的自動化操作。</p> <p>例如不能在 commit 中寫 <code class="language-plaintext highlighter-rouge">Fixes: #xxx</code>、<code class="language-plaintext highlighter-rouge">Thanks @xxx</code> 等，這些要移到 PR 說明欄。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/08/k8s-invalid-commit.jpg" alt="無效的 commit 訊息" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">無效的 commit 訊息（<a href="https://github.com/kubernetes/website/pull/34456" target="_blank">k/website#34456</a>）</td> </tr> </tbody> </table> <p><kbd>needs-rebase</kbd>，偵測到 merge conflict 時會自動加上此標籤，解決後這個標籤就會自動消失了。</p> <p><kbd>do-not-merge/work-in-progress</kbd>，只要在標題前面加上 <code class="language-plaintext highlighter-rouge">[WIP]</code>，或透過 GitHub 介面設定為 Draft PR，就能得到這個標籤了。</p> <h2 id="triage-labels">分類標籤</h2> <p>最直覺簡單的就屬檔案大小了，計算方式是新增的行數與刪除的行數相加。<br /> 這可以幫大家快速判斷需要花多少時間 review，也提醒沒事不要塞一大坨更動，讓 PR 變成過於肥大。<br /> 例如最小的 <kbd>size/XS</kbd> 代表更動了 0 - 9 行，到修改超過 1000+ 行的 <kbd>size/XXL</kbd>。</p> <p>根據不同的面向，會被標上不同的 SIG 特別興趣小組（special interest group）標籤：<br /> <kbd>sig/docs</kbd>、<kbd>sig/release</kbd>、<kbd>sig/security</kbd></p> <p>有些 PR 也會被標上屬於哪個領域：<br /> <kbd>area/blog</kbd>、<kbd>area/web-development</kbd></p> <p>在各語言的資料夾中，會被標上語言標籤，方便在地化翻譯者們過濾：<br /> <kbd>language/zh</kbd>、<kbd>language/en</kbd>、<kbd>language/ko</kbd></p> <p>對於 issue，則是分為不同的種類：<br /> <kbd>kind/feature</kbd>、<kbd>kind/bug</kbd>、<kbd>kind/support</kbd>、<kbd>kind/cleanup</kbd></p> <h1 id="roles">社群成員身份</h1> <p>全球 500 萬名 Kubernetes 開發者的數量龐大，光是 k/website 就有 4,100 位貢獻者了，因此 k8s 社群也有一套相對成熟的權限機制。</p> <h2 id="role-overview">身份總覽</h2> <p>在開始詳細介紹之前，先讓我快速整理一下 Kubernetes 組織中各身份擁有的大略權限。</p> <h3 id="role-anyone">(A) 任何人</h3> <p>只要有 GitHub 帳號都可以發 PR、幫忙 review 給意見</p> <h3 id="role-member">(B) Member 組織成員</h3> <p>可以用 <code class="language-plaintext highlighter-rouge">/lgtm</code> 指令表示看過、沒問題</p> <p>也能用 <code class="language-plaintext highlighter-rouge">/close</code>、<code class="language-plaintext highlighter-rouge">/hold</code>、<code class="language-plaintext highlighter-rouge">/retitle</code> 等指令管理 PR</p> <h3 id="role-reviewer">(C) Reviewer 審核者</h3> <p>在有人發新的 Pull Request 時，bot 會隨機指派 2 位 Reviewer</p> <h3 id="role-approver">(D) Approver 批准者</h3> <p>在 PR 被初步 review 過後，會指派 Approver 來做最終確認</p> <p>在 Approver 確認過大方向無誤後，可以用 <code class="language-plaintext highlighter-rouge">/approve</code> 指令核可</p> <h3 id="role-owner">(E) Tech Lead / Maintainer / Owner</h3> <p>有專案的管理權限、可以設定 <code class="language-plaintext highlighter-rouge">/milestone</code> 指定合併的目標時間</p> <h2 id="start-contributing">如何開始這場冒險</h2> <p>第一步當然是先熟悉社群、開 issue 發 PR，實際瞭解社群運作。</p> <p>在找到問題準備修復前，最好可以找 3 - 10 個 PR，看看大家是如何互動的，幫助自己更快融入社群。</p> <h2 id="member">Member 組織成員</h2> <p>要成為 Member 的門檻非常低，只要發 5+ 個 PR，並找 2 位 Reviewer 協助背書（sponsor），就可以申請成為組織成員。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/08/k8s-apply-member.jpg" alt="申請成為 Kubernetes 組織成員" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">申請成為 Kubernetes 組織成員（<a href="https://github.com/kubernetes/org/pull/3440" target="_blank">k/org#3440</a>）</td> </tr> </tbody> </table> <p>很酷的一點是，Kubernetes 社群連 GitHub 組織成員都是用 git 管理、自動更新同步的，只要修改對應的 YAML 設定檔，<code class="language-plaintext highlighter-rouge">@k8s-ci-robot</code> 就會自動寄發邀請函。</p> <p>接受邀請成為 Kubernetes 組織成員後，就有了 <code class="language-plaintext highlighter-rouge">/lgtm</code> 半通過、<code class="language-plaintext highlighter-rouge">/close</code> 關閉 PR、<code class="language-plaintext highlighter-rouge">/hold</code> 要求暫緩等大多數的權限，可以隨時參與 PR review。</p> <h2 id="reviewer">Reviewer 審核者</h2> <p>如果想成為 Reviewer 身份，規定上的最低限制是成為 Member 至少 3 個月，並且 review 過至少 20 個 PR。</p> <p>在自認對整個專案程式碼的大架構足夠熟悉後，就可以找 Approver 協助背書，送出申請。</p> <p>這邊的申請流程跟成為 Member 不同的是，申請的 PR 可以自己開就好，只要約 12 - 48 小時就能成功了。<br /> 前面提到想成為 Member 的話需要先開 issue，等過了 3 - 30 天後負責人有空時，才會來批次處理加入申請。或許也跟 Member 身份門檻較低、申請數量過多有關吧。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/08/k8s-apply-reviewer.jpg" alt="申請成為 Kubernetes 的 Reviewer" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">申請成為 Kubernetes 的 Reviewer（<a href="https://github.com/kubernetes/org/pull/3436" target="_blank">k/org#3436</a>）</td> </tr> </tbody> </table> <p>以 k/website 的中文語系為例，每當有新的 <kbd>language/zh</kbd> PR 時，就會在 <code class="language-plaintext highlighter-rouge">sig-docs-zh-reviews</code> 之中隨機指派兩個人為 PR reviewer，以確保在大家不會累死自己的前提下，每個 PR 都有人能幫忙處理。</p> <p>這身份承擔的責任在某些時候還蠻重的，但似乎沒有額外授予其他權限，比較像是願意為社群付出、為下一階段鋪路。</p> <h2 id="approver">Approver 核可者</h2> <p>在擔任 Reviewer 至少 3 個月後，就可以由 Subproject Owner 提名為 Approver 了。</p> <p>擔任 Approver 必須在技術層面展現合理的判斷，為程式碼品質做高層次的把關，並作為新進貢獻者們的導師。</p> <p>願意在社群持續貢獻半年一年的志願者們，通常都能順利取得這個身份，相應的 <code class="language-plaintext highlighter-rouge">/approve</code> 權限賦予 Approver 們決定 PR 能不能被合併到專案的權力。</p> <h2 id="owner">Subproject Owner / Tech Lead / Maintainer / Admin</h2> <p>後續身份沒有一套通用的準則，在取得社群內大家的信任後，得到更多的權限也代表著更大的責任。</p> <p>像是我很好奇那幾位主要貢獻者們到底是怎麼管理時間的，都已經有正職工作了還有辦法投入那麼大的心力在開源貢獻。</p> <h1 id="epilogue">後記</h1> <p>我在六月成功加入 Kubernets 組織，因為很喜歡這邊的社群氛圍，期間持續發 PR、幫別人 review，這段期間算是相對積極的貢獻者。</p> <p>剛成為 Member 才 2 個月的我，在上週被 k/website 最主要的維護者破例提名為 Approver 且通過了，讓我覺得非常驚喜。</p> <p>因此整理相關資訊分享給身邊的社群朋友們，希望未來有更多人一起加入，期待能做出更多有意義的貢獻。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/08/k8s-nominated.jpg" alt="被提名為中文 Approver" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">被提名為中文 Approver（<a href="https://github.com/kubernetes/website/pull/35563" target="_blank">k/website#35563</a>）</td> </tr> </tbody> </table> <p>本文同步分享於 <a href="https://t.me/SeanChannel/106" target="_blank">Telegram</a>、 <a href="https://twitter.com/Sea_n64/status/1555836080083320833" target="_blank">Twitter</a>、 <a href="https://www.facebook.com/Sean0604/posts/3256233521315151" target="_blank">Facebook</a>，如果有什麼想法歡迎留言讓我知道。</p> <p>如果有興趣一起成為 Kubernetes 的貢獻者，歡迎加入 <a href="https://t.me/SeanTalk" target="_blank">@SeanTalk</a> 及 <a href="https://t.me/CNTUG" target="_blank">@CNTUG</a> 群組一同交流。</p> <h1 id="reference">參考連結</h1> <ul> <li>GitHub 專案連結：<a href="https://github.com/kubernetes/website" target="_blank">kubernetes/website</a></li> <li>Kubernetes 社群文件：<a href="https://github.com/kubernetes/community/blob/master/community-membership.md" target="_blank">Community membership</a>、 <a href="https://kubernetes.io/docs/contribute/" target="_blank">Contribute to K8s docs</a></li> <li>實戰教學文：<a href="https://ndx.gitpages.daocloud.io/product/doc-template/zh/other/k8s-member.html">快速成為 K8s Member</a></li> <li>COSCUP 議程投影片：<a href="https://speakerdeck.com/ydfu/how-to-start-contributing-to-kubernetes-projects" target="_blank">How to start contributing to Kubernetes Projects</a></li> </ul> <style> .post h3 { margin: -2px 0 6px 0; } .post table td { color: #666; } .post table td a { color: #6bf; } .post table td a:hover, .post table td a:active, .post table td a:focus { color: #8cf; } </style>

2022/8/5

來迺陽明交大水所在陽交校慶系列活動

<h1 id="前言">前言</h1> <p>上週三 1/26 看到活動後，晚上臨時起意想藉這個機會參訪各大校區，趁著年假走訪完 10 個校區、共 50 個景點啦～</p> <p>經過親身走訪（踩雷）後，原本想在留言提供活動破關技巧的，但愈寫愈長就乾脆獨立一篇文章出來，若是哪裡內容不夠充足還請不吝告知。</p> <h1 id="參訪歷程">參訪歷程</h1> <p>由於一開始沒有打定主意挑戰全部達成，因此時間上分為三段旅程。</p> <h2 id="第一段旅程">第一段旅程</h2> <p>上週四 1/27 中午睡醒後，從山頂的研三舍出發，看著活動地圖規劃路線後，先用 40 分鐘走訪光復校區每個拍照點，再搭校車去陽明吃午餐。</p> <p>吃完鮭魚親子丼後，第一次踏入陽明校園，尋找打卡點的途中有些曲折（見下段闖關攻略），隨著愈爬愈深入，頭髮也因汗水愈來愈濕，用花了 90 分鐘爬山、尋點，終於順利找到所有打卡點。</p> <p>完成光復及陽明各 15 個景點後，借了陽明圖書館旁的 YouBike 2.0，騎腳踏車前往興建中的士林校區拍照，結束後再轉乘公車到管理學院使用的北門校區。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/02/nycu-sl.jpg" alt="來迺陽明交大水所在興建中的士林校區" /></th> <th style="text-align: center"><img src="https://img.sean.taipei/2022/02/nycu-bm.jpg" alt="來迺陽明交大水所在北門校區交大管理學院" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">興建中的士林校區</td> <td style="text-align: center">北門管院校區</td> </tr> </tbody> </table> <h2 id="第二段旅程">第二段旅程</h2> <p>原先最不考慮的是蘭陽院區，但發上噗浪跟朋友聊了之後，一查才發現宜蘭是真的是離台北很近，開始規劃行程後就愈來愈確定要去了。</p> <p>揪了朋友週六 1/29 下午出發，搭乘國道客運抵達礁溪後，沿路買了些在地美食，傍晚欣賞礁溪夜景，晚上回飯店泡溫泉。隔天 1/30 吃完飯店早餐後，再去了重口味溫泉魚，中午搭火車到宜蘭。</p> <p>區間車抵達宜蘭站後，蘭陽院區跟新民分院都在步行 10 分鐘範圍內，各別拍照留影後，就買個伴手禮搭國道客運回家。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/02/nycu-ly.jpg" alt="來迺陽明交大水所在蘭陽附設醫院" /></th> <th style="text-align: center"><img src="https://img.sean.taipei/2022/02/nycu-sm.jpg" alt="來迺陽明交大水所在宜蘭附設醫院新民分院" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">蘭陽附設醫院</td> <td style="text-align: center">宜蘭新民分院</td> </tr> </tbody> </table> <h3 id="桃園青埔">桃園青埔</h3> <p>原先在新聞報導及維基百科都只提到位於青埔，沒有確切路名或地圖，週日晚上與另一位桃園同學聊天時，意外的從籌設計畫書對照出了青埔全球校區的實際位址。<br /> 不過透過 Google 街景或 OSM 上的衛星空拍照都只看到一片荒地，雖然不知道可以從何處拍攝，但還是打定主意隔天起床後前往。</p> <p>除夕 1/31 中午搭高鐵到桃園，坐一站機場捷運到 A19 桃園體育園區站後，發現月台上的角度恰好能清楚看到青埔校區建築預定地，喬好角度拍完照後就原路折返了，回到樹林整趟旅程只用了 3 小時。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/02/nycu-ty.jpg" alt="來迺陽明交大水所在桃園青埔全球校區建築預定地" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">桃園青埔全球校區建築預定地（圖中灰色三角形空地）</td> </tr> </tbody> </table> <h2 id="第三段旅程">第三段旅程</h2> <p>初三 2/3 早上七點起床，跟家人去苗栗大湖親戚家採草莓，結束後下午回台北的路上，再順道載我回交大宿舍。</p> <p>今天初四 2/4（五）睡飽後，上午先到博愛校區踩點，再去六家客院拍照，準備搭高鐵。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/02/nycu-ba.jpg" alt="來迺陽明交大水所在" /></th> <th style="text-align: center"><img src="https://img.sean.taipei/2022/02/nycu-lj.jpg" alt="來迺陽明交大水所在" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">博愛校區</td> <td style="text-align: center">六家客院</td> </tr> </tbody> </table> <h3 id="台南歸仁">台南歸仁</h3> <p>中午抵達高鐵台南站，最遠的歸仁校區也達成啦！因為想說來台南至少玩個一天再回去，不過適逢年假返家人潮，六日的高鐵對號座都已完售，所以有點過分的待到初七 2/7（一）才回家。</p> <p>再來的 3 天要在做好防疫準備的前提下，多品嚐台南在地美食、去高雄逛燈會，讓自己放個寒假。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/02/nycu-tn.jpg" alt="來迺陽明交大水所在" style="max-height: 40vh;" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">台南歸仁校區</td> </tr> </tbody> </table> <h1 id="闖關攻略">闖關攻略</h1> <p>雖然 8 個校區看起來很多，但其實也就新竹台北各 3 個、宜蘭台南各 1 個。如果願意捨棄蘭陽院區、台南歸仁，其實這活動只要一天時間就能達成了，而且交通成本 $50 有找。</p> <h2 id="新竹">新竹</h2> <p>光復校區的景點有按照建議順序編排過，只要從任意數字開始依序或逆序走訪，剛好可以用適合人類的最短路徑繞一圈完成。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/02/nycu-spec-ct.jpg" alt="來迺陽明交大水所在新竹光復校區活動景點地圖" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">新竹光復校區活動景點地圖（來源：活動頁面）</td> </tr> </tbody> </table> <p>新竹拍完光復校區後，可以騎 YouBike 或搭校車去博愛校區。<br /> 回到光復後，再搭校車去六家校區，享受客院人文氣息。</p> <p>以下是 <a href="https://www.ga.nctu.edu.tw/general-division/traffic">總務處事務組</a> 提供的校車時刻表，除了例假日及春節停駛，學期間班次還算多。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/02/nycu-bus-ba.jpg" alt="來迺陽明交大水所在光復博愛線交通接駁車時刻表" /></th> <th style="text-align: center"><img src="https://img.sean.taipei/2022/02/nycu-bus-lj.jpg" alt="來迺陽明交大水所在客院高鐵線交通接駁車時刻表" /></th> <th style="text-align: center"><img src="https://img.sean.taipei/2022/02/nycu-bus-ym.jpg" alt="來迺陽明交大水所在光復陽明線交通接駁車時刻表" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">光復博愛線</td> <td style="text-align: center">客院高鐵線</td> <td style="text-align: center">光復陽明線</td> </tr> </tbody> </table> <p>完成新竹 3 個校區的任務後，到中正堂搭光復 - 陽明接駁車，還能順便抽「呷意陽光獎」。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/02/nycu-spec-prize.jpg" alt="來迺陽明交大水所在活動獎項呷意陽光獎" style="max-height: 60vh;" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">活動獎項（來源：活動頁面）</td> </tr> </tbody> </table> <h2 id="陽明">陽明</h2> <p>雖然陽明校區的編號較無規則，但 15 個景點大致沿著主要幹道分佈。參考下圖的建議路線開始往上爬，基本上就能（很喘得）輕鬆完成。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/02/nycu-spec-ym.jpg" alt="來迺陽明交大水所在台北陽明校區活動景點地圖" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">台北陽明校區活動景點地圖（來源：活動頁面）</td> </tr> </tbody> </table> <p>有幾個我當初找比較久的景點供參考：</p> <p><strong>(8) 憶空間</strong>：位於圖書館內，要走大馬路那側（西側）進去，不是圖上標示的位置。</p> <p><strong>(3) 三角公園</strong>：現在只有全綠一片，看到岔路就可以拍照了，信中照騙是以前的樣子。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/02/nycu-ym-03.jpg" alt="來迺陽明交大水所在三角公園" style="max-height: 30vh;" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">三角公園實際樣貌</td> </tr> </tbody> </table> <p><strong>(4) 金門石</strong>：在 (1) 榕園裡面，建議用不同角度拍攝避免爭議。</p> <p><strong>(13) 陽明廣場</strong>：從上方繞過牙醫學院後，順著樓梯往下走。可以參考衛星空拍圖，紅色點即為陽明廣場，可走綠色箭頭的路線到達。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/02/nycu-map-square.jpg?" alt="來迺陽明交大水所在陽明廣場衛星空拍圖" style="max-height: 30vh;" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">陽明廣場衛星空拍圖</td> </tr> </tbody> </table> <p><strong>(5) 神農坡</strong>：範例圖片要求要山腳下的刻字，可以爬上 (9) 異空間後再往下走。</p> <p><strong>(2) 韓園</strong>：位於人行步道上，共同教育中心與山頂網球場中間，別像我傻傻照著圖片地標跑到大馬路上找不到。</p> <p><strong>(6) 韓偉石</strong>：位於 (2) 韓園字樣後方，寫著「非以役人，乃役於人」。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/02/nycu-ym-02.jpg" alt="來迺陽明交大水所在韓園" style="max-height: 30vh;" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">韓園內紀念碑</td> </tr> </tbody> </table> <p>如果還是找不到，可以參考我那天 Google Photos 記錄的路徑、拍照點，主辦單位給的編號已經用紅色字標示在上面了。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/02/nycu-map-ym.jpg" alt="來迺陽明交大水所在陽明闖關攻略地圖" style="max-height: 80vh;" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">陽明闖關攻略地圖</td> </tr> </tbody> </table> <p>一路逛到山頂運動場後，可以走最短路徑下來到圖書館，借台 YouBike 2.0 前往下一個校區。</p> <h2 id="台北">台北</h2> <p>從陽明圖書館出發，照著導航往下坡騎，預計 20 分鐘就能到興建中的士林校區了。可以先不要還腳踏車，停在工地前面的停車場人行道，拍完照再往回騎 200 公尺去志成公園還車。</p> <p>還完車後往前走幾步就是公車站了，搭 206 到捷運北門站附近後，再徒步 10 分鐘就能抵達北門校區了。</p> <p>我的終點是走去西門町吃飯、回到樹林的家；如果是要搭豪泰回學校的話，也能當天來回，不過回程的交通成本就容我先忽略不計了。</p> <h1 id="後記">後記</h1> <p>到家後在想參訪陽明怎麼能那麼累，查了地圖才知道，從大門口走到山頂的水平距離同樣是 700 公尺，交大只爬升 30 公尺，但陽明卻整整爬升了 130 公尺。<br /> 事後想想都走到山頂田徑場了，距離唭哩岸山、軍艦岩也沒多遠，其實可以考慮繼續往上爬才對，是當時沒做足功課。</p> <p>感謝總務處發想這個 <a href="https://anniv.web.nycu.edu.tw/%e6%a0%a1%e6%85%b6%e8%97%9d%e6%96%87%e6%b4%bb%e5%8b%95/%e4%be%86%e8%bf%ba%e9%99%bd%e6%98%8e%e4%ba%a4%e5%a4%a7%e6%b0%b4%e6%89%80%e5%9c%a8/">校慶系列活動</a>，否則除了光復、陽明、博愛外，不會有去其他校區的契機。</p> <p>從粉專大略整理，簡單記錄一下聲稱完成 8 校區共 36 景點的同學們：</p> <table> <thead> <tr> <th style="text-align: center">名次</th> <th style="text-align: center">暱稱</th> <th style="text-align: center">完成日期</th> </tr> </thead> <tbody> <tr> <td style="text-align: center">1</td> <td style="text-align: center">陳*霖</td> <td style="text-align: center">2022-02-01</td> </tr> <tr> <td style="text-align: center">2</td> <td style="text-align: center">Sean Wei</td> <td style="text-align: center">2022-02-04</td> </tr> <tr> <td style="text-align: center">3</td> <td style="text-align: center">洪*勛</td> <td style="text-align: center">2022-02-07</td> </tr> <tr> <td style="text-align: center">4</td> <td style="text-align: center">包*承</td> <td style="text-align: center">2022-02-08</td> </tr> <tr> <td style="text-align: center">5</td> <td style="text-align: center">David Chen</td> <td style="text-align: center">2022-02-08</td> </tr> <tr> <td style="text-align: center">6</td> <td style="text-align: center">Calvin</td> <td style="text-align: center">2022-02-09</td> </tr> <tr> <td style="text-align: center">7</td> <td style="text-align: center">葉*妤</td> <td style="text-align: center">2022-02-12</td> </tr> <tr> <td style="text-align: center">8</td> <td style="text-align: center">YC Shun</td> <td style="text-align: center">2022-02-12</td> </tr> <tr> <td style="text-align: center">9</td> <td style="text-align: center">Ann Cheung</td> <td style="text-align: center">2022-02-15</td> </tr> </tbody> </table> <p>這次響應活動 5 個縣市跑下來，雖然光是交通住宿就肯定超過第 2 名的 $5,000 獎金，寫成文字紀錄所額外花費的時間成本更不用說，但滿滿的收穫不是金錢能衡量的，很鼓勵大家也來享受這活動的樂趣。</p> <table> <thead> <tr> <th style="text-align: center"><img src="https://img.sean.taipei/2022/02/nycu-ym.jpg" alt="來迺陽明交大水所在國立交通大學陽明校區校名掛牌" /></th> </tr> </thead> <tbody> <tr> <td style="text-align: center">國立陽明交通大學台北陽明校區</td> </tr> </tbody> </table> <p>本文同步分享於 <a href="https://t.me/SeanChannel/102">Telegram</a>、 <a href="https://twitter.com/Sea_n64/status/1489509903802593281">Twitter</a>、 <a href="https://www.facebook.com/Sean0604/posts/3120098928261945">Facebook</a>，如果有什麼想法，或是願意協助補充，都歡迎來留言讓我知道，祝順利達成任務！</p>

2022/2/4

CEH v11 證照考試心得

<h1 id="前言">前言</h1> <p>我在一年半前的那個暑假，進入交大資工系計中擔任 Net 組及 Web 組助教，協助維護整棟資工系館的網路、機房、監控服務，以及系院網站、推甄系統、口試系統等服務。</p> <p>在 2021 年 10 月底的某個早上，看到系計中的團長（行政事務窗口）通知大家，說有 CEH 公費培訓可以報名，就相揪把握機會參加了！</p> <p>這次培訓是配合 <a href="https://www.ithome.com.tw/news/142509" target="_blank">資安卓越計畫</a> 辦理，交大作為區網中心，又有酷炫的資電駭客研究所，預計成為第一批執行弱點掃描、滲透測試的教育單位，因此培育各系所網管考取 CEH 道德駭客認證。</p> <p>連續 5 個週日，由恆逸講師來交大授課，每天 8 小時的課程，考證照也是在同一間電腦教室。培訓課程會用原廠的簡報（未提供給學生）上課，也有把 Kali、Win Server 包成 VM，開 RDP 給學員們在課程期間使用，教材只提供線上版本，啟用 ASPEN 平台帳號後就能開啟電子書。</p> <p>受訓對象除了資工系計中外，也將課程資訊發給了交清資安相關背景的實驗室，報名資料經過教育部審核後，很高興包含我、 <a href="https://coder.tw/" target="_blank">Karl Lin</a>、 <a href="https://www.freemansky.com/" target="_blank">Freeman Hung</a> 等人，系計中共有 5 位助教取得培訓資格。</p> <h1 id="ceh-是在考什麼">CEH 是在考什麼</h1> <p>就像其他篇心得文，我也來挑一題具代表性的題目作為開場：</p> <blockquote> <p>Morris, a professional hacker, performed a vulnerability scan on a target organization by sniffing the traffic on the network to identify the active systems, network services, applications, and vulnerabilities. He also obtained the list of the users who are currently accessing the network.<br /> 專業駭客 Morris 透過 sniffing 網絡上的流量對目標組織執行漏洞掃描，以識別系統、網絡服務、應用程式和漏洞，他還取得了目前正在上網的使用者清單。</p> <p>What is the type of vulnerability assessment that Morris performed on the target organization?<br /> 請問 Morris 對目標組織執行的是哪種類型的漏洞評估？</p> <p>（A）Internal assessment<br /> （B）External assessment<br /> （C）Passive assessment<br /> （D）Credentialed assessment</p> <p>（答案在本段落最後）</p> </blockquote> <p>全名 Certified Ethical Hacker 道德駭客認證，這張證照的重點在道德、認證，對於有接觸過 CTF 的同學們，駭侵技術反而是最簡單的部分。會考這張證照的不外乎標案需要、組織 KPI 要求、佐證自己擁有基本資安能力，為了學習資安而上課的考生可能只佔很小一部分。</p> <p>教材總共有 20 個章節，含附錄共 4,000 頁，應該多數人都是在上完課後，直接從考古題下手。<br /> <img src="https://img.sean.taipei/2022/01/vitalsource.png" alt="CEH 電子書使用介面" /></p> <p>涵蓋面向包含：情蒐偵查、系統駭侵、攻擊技巧、網頁安全、網路安全、手機、IoT、工控設備、無線網路、道德觀念、密碼學、雲端運算等。</p> <p>對我來說考題印象最深刻的是各種 nmap 參數、沒見過的工具名稱、早期技術。有人會說與現實脫節，但其實看考題還是能學到一些觀念、專有名詞、冷知識，或許能讓討論時用較精確的語言表述。</p> <p>前面這題的答案是 <code class="language-plaintext highlighter-rouge">（C）Passive assessment</code>，我在第一次看到時完全沒考慮過這個選項，再看一次題目才發現這題重點在 sniffing 這個行為。CEH 考題有蠻多都需要理解，多刷考古瞭解他想問什麼，才不容易被誤導。</p> <h1 id="考前準備">考前準備</h1> <p>初期上課時，我是用 <a href="https://ceh.cagy.org/" target="_blank">ceh.cagy.org</a> 這套線上 CEH 考古題系統，刷 CEH v10 的題目。這套系統再進入模擬測驗後，是用 Local Storage 在本機存題目跟狀態的，於是後來拿到另一份考古題時，在自己整理過後能很方便地將題目匯入來用。<br /> <img src="https://img.sean.taipei/2022/01/cagy.png" alt="CEH 考古題 cagy 操作介面" /></p> <p>也有用 <a href="https://www.examtopics.com/exams/eccouncil/312-50v11/view/" target="_blank">Exam Topics</a> 來看 v11 的考古題，不過每頁只顯示 10 題，翻個兩頁就開始一直跳驗證碼了，而且少了作答正確率用起來較不習慣，對我來說主要用途是在手邊的考古題出現爭議時，可以參考此網站上的討論。<br /> <img src="https://img.sean.taipei/2022/01/examtopics.png" alt="CEH 考古題 Exam Topics 介面" /></p> <p>後來同學們合資買了考古題，拿到幾百題的 PDF 題庫後，花了些時間用 Sublime Text 整理成正確格式後，再寫個 Python 腳本轉換成 JSON 格式，每次隨機抽 125 題出來練習；也有同學直接轉換成 Anki 格式，用背單字的方式來背考古。在刷題時，發現有的答案甚至是錯的，幾位一起參加培訓的同學討論、查資料對照後，手動修正了十幾題。</p> <h1 id="考照過程">考照過程</h1> <p>在簽到進入訓練教室後，用自己的帳號密碼、考試 Voucher Code 序號，搭配監考官的密碼即可開始作答。</p> <p>考試題目是共 125 題的四選一單選題，限時 4 小時。之前在網路上看到都說及格門檻依難度浮動調整，會是 60% 到 85%，不過我考到的這次在開始作答前的說明文字寫及格門檻 70%、只要答對 87 題就能通過，考後搜尋起來也是如此，不確定是制度改變還是怎麼樣。</p> <p>系統設計上是回答完一題後，可以選擇作答或標記（未標記的題目也還能修改），才會出現下一題題目，不能往後跳到還沒開放的題號。<br /> 在點回前面的題目後，點作答或標記都會直接跳到最後一題，無法快速檢查有疑義的題目，也不適合全部檢查一輪。滑鼠移到題號上方，可以預覽該題的題目、選項，算是不錯的功能。</p> <p>我們的考試時間安排在週日下午 13:00 開始，雖然有不少題目與考古題重複，看到可以秒選答案，但因為卡到期末只刷 150 題就上場的我，還是很多要靠英文閱讀。</p> <p>據同學說法，如果是以拿到證照為目標，有買考古題、認真背過一輪，不用上課也能考到高分，但這就是大家瞧不起的 Paper CEH。</p> <p>沒想到才過半小時就聽到有人離場的聲音了，因為正確與否是要交卷才會知道，過程中很擔心萬一沒考過該怎麼辦；我考了快兩小時才寫完檢查交卷，教室內大概只剩一兩成的考生了。</p> <p>交卷後，馬上能看到自己答對的題數、通過與否，我拿了 104 分（83.2%）。<br /> <img src="https://img.sean.taipei/2022/01/eccexam-top.png" alt="成績單上半部" /></p> <p>離開考場、再次登入系統後，可以下載成績單看自己 9 大主題的正確率。<br /> <img src="https://img.sean.taipei/2022/01/eccexam-bottom.png" alt="成績單下半部" /></p> <h1 id="後記">後記</h1> <p>在培訓開始前兩天，課前提醒的信件提到雖然補助含課程及考照，但假如沒過就要自費補考（原廠補考價 $500 USD），拿到證照後有義務要參與資安檢測作業。</p> <p>目前還尚未對學生公布檢測目標、檢測範圍大小、結果報告需求等詳細資訊，有擔心過不知道概略性的空白支票會不會被凹得太誇張，但後來基於信任負責單位，加上光考照本身就要價 $1,200 USD，還是決定繼續參加。</p> <p>如果要問我看法的話，雖然知道 CEH 證照本身具有一定效力，但絕對不是會想自費去考的項目，只有在業務上有需要、公司出錢的前提下才會考慮。資安社群的前輩們肯定都有遠超越 CEH 的能力，要是像 <a href="https://apcs.csie.ntnu.edu.tw/" target="_blank">APCS</a> 那樣親民，可能就會人手一張 CEH 了。</p> <p>BTW, 我在 <a href="https://aspen.eccouncil.org/MyCourses" target="_blank">ASPEN</a> 課程平台跟 <a href="https://www.eccexam.com/" target="_blank">Exam Center</a> 考試平台用了不同的信箱地址，結果發證照時被自動註冊了一個新帳號，變成這樣神奇的情況。還有我在註冊考試平台時竟然把英文名字打錯了一個字母，在拿到證書後才發現不對勁，還好聯絡客服人員就能順利更正了。<br /> <img src="https://img.sean.taipei/2022/01/aspen.png" alt="ASPEN 平台" /></p> <p>不免俗的還是要放一下證照本體，可以 <a href="" onclick="document.getElementById('magic').submit(); return false;">在 EC-Council 官網</a> 用姓名 <code class="language-plaintext highlighter-rouge">Yung-Hsiang Wei</code> 與證照序號 <code class="language-plaintext highlighter-rouge">ECC2813064597</code> 驗證有效性。<br /> <img src="https://img.sean.taipei/2022/01/ceh.png" alt="Yung-Hsiang Wei CEH 證照 ECC2813064597" /></p> <form target="_blank" id="magic" method="POST" action="https://aspen.eccouncil.org/verify"> <input type="hidden" name="txtname" value="Yung-Hsiang Wei" /> <input type="hidden" name="txtcert_number" value="ECC2813064597" /> </form> <h1 id="文章推薦">文章推薦</h1> <p>沒意外的話本文內容應該不會繼續更新，如果正在閱讀的你考過後有整理相關資源，歡迎讓我知道、列在這邊供後人參考。</p> <ul> <li><a href="https://medium.com/blacksecurity/ceh-v10-4598422fc644" target="_blank">CEH 考試心得與讀書資料分享 by Kuro Huang</a>（2019 年 12 月）</li> <li><a href="https://medium.com/@finn79426/ceh-v10-ea278920456d" target="_blank">CEH v10 考試心得 by 小曹</a>（2020 年 1 月）</li> <li><a href="https://medium.com/sean/ceh-v11-33f874751162" target="_blank">CEH v11 考試心得 by 禹璿</a>（2021 年 10 月）</li> <li><a href="https://ithelp.ithome.com.tw/users/20103647/ironman/1300" target="_blank">CEH 之越挫越勇 by 胭脂虎</a>（2017 年 12 月）</li> </ul> <p>本文同步分享於 <a href="https://twitter.com/Sea_n64/status/1481868746251636737" target="_blank">Twitter</a>、 <a href="https://t.me/SeanChannel/101" target="_blank">Telegram</a>、 <a href="https://www.facebook.com/Sean0604/posts/3104849129786925" target="_blank">Facebook</a>，如果有什麼想法，或是協助勘誤，都歡迎來留言討論；如果你是因為準備 CEH 證照考試而查到本文的，有遇到問題都 <a href="https://t.me/SeanTalk" target="_blank">歡迎來聊聊</a>，祝順利考到證照！</p>

2022/1/14

Unicode Normalization 文字標準化

<h1 id="recap">事由</h1> <p>在交大資工的某個系統中，需要將使用者輸入的資料產生成 PDF 文件，在某幾位老師的名字中出現缺漏字的狀況。</p> <p>例如這三個關鍵字，從肉眼看來都是正常字元，但搜尋起來數量差異非常大：</p> <ul> <li><a href="https://www.google.com/search?q=%22%E5%B9%B4%E6%9C%88%E2%BD%87%22" title="U+5E74 U+6708 U+2F47">年月⽇</a>：1,000 筆 / <a href="https://www.google.com/search?q=%22%E5%B9%B4%E6%9C%88%E6%97%A5%22" title="U+5E74 U+6708 U+65E5">年月日</a>：50,000,000 筆</li> <li><a href="https://www.google.com/search?q=%22%E6%9D%8E%E2%BC%A9%E2%BF%93%22" title="U+674E U+2F29 U+2FD3">李⼩⿓</a>：100 筆 / <a href="https://www.google.com/search?q=%22%E6%9D%8E%E5%B0%8F%E9%BE%8D%22" title="U+674E U+5C0F U+9F8D">李小龍</a>：3,000,000 筆</li> <li><a href="https://www.google.com/search?q=%22%E2%BE%A6%E6%9C%A8%E2%BD%94%E7%81%AB%E2%BC%9F%22" title="U+2FA6 U+6728 U+2F54 U+706B U+2F1F">⾦木⽔火⼟</a>：1 筆 / <a href="https://www.google.com/search?q=%22%E9%87%91%E6%9C%A8%E6%B0%B4%E7%81%AB%E5%9C%9F%22" title="U+91D1 U+6728 U+6C34 U+706B U+571F">金木水火土</a>：9,000,000 筆</li> </ul> <p>由於前者是罕用/相容性字碼，可以看到只會出現少數搜尋結果；而作為對照組的後者是同個字面的常用字碼，搜尋結果數量差異高達萬倍。</p> <h2 id="cause">推測發生原因</h2> <p>先前遇過相同問題的情境，是源自於 macOS 的 Pages 匯出為 PDF 時，雖然肉眼看起來完全正常，但內部儲存的文字不如直覺所想得一樣。</p> <p>例如在 Pages 中寫「更加精進自己的能力」，匯出成 PDF 後看起來完全正常，不過複製文字或是 Google 索引到的文字卻變成「<a href="https://www.google.com/search?q=%22%E6%9B%B4%E6%9B%B4%E5%8A%A0%E7%B2%BE%E9%80%B2%E2%BE%83%E8%87%AA%E2%BC%B0%E5%B7%B1%E7%9A%84%E8%83%BD%E2%BC%92%E5%8A%9B%E5%8A%9B%22" title="U+66F4 U+66F4 U+52A0 U+7CBE U+9032 U+2F83 U+81EA U+2F30 U+5DF1 U+7684 U+80FD U+2F12 U+529B U+529B">更更加精進⾃自⼰己的能⼒力力</a>」，可以看到長得一樣的字重複了兩三次。</p> <p>對於不暸解其中原理的多數人而言，很可能以為兩個字完全一樣就隨意刪掉其中一個；然而對電腦而言，重複的兩個字編碼卻不同，猜錯/刪錯了就會導致資料庫搜尋時無法正常匹配。</p> <h1 id="nf">Normalization Forms 標準化格式</h1> <p>由於有些字元可被拆分成許多 Component（部件），同一個字面又可以用不同編碼呈現，因此 Unicode 組織研擬了一套標準化的演算法，幫每一組字串產生唯一的字碼序列。</p> <p>其中依據「標準化拆解 / 相容性拆解」、「純拆解 / 拆完再標準化組裝」兩種屬性，分為 NFD、NFC、NFKD、NFKC 四種標準化格式（通稱為 NFx），適合在不同情境使用。</p> <table> <thead> <tr> <th style="text-align: center">標準化格式</th> <th style="text-align: center">代表意義</th> </tr> </thead> <tbody> <tr> <td style="text-align: center">NFD</td> <td style="text-align: center">標準化拆解</td> </tr> <tr> <td style="text-align: center">NFC</td> <td style="text-align: center">標準化拆解，再標準化組裝</td> </tr> <tr> <td style="text-align: center">NFKD</td> <td style="text-align: center">相容性拆解</td> </tr> <tr> <td style="text-align: center">NFKC</td> <td style="text-align: center">相容性拆解，再標準化組裝</td> </tr> </tbody> </table> <p>以下節錄自 <a href="https://unicode.org/reports/tr15/" title="Unicode Standard Annex #15">UAX #15 標準附錄</a> 範例並加以說明：</p> <h2 id="singletons">Singletons</h2> <p><img src="https://unicode.org/reports/tr15/images/UAX15-NormFig3.jpg" alt="Figure 3. Singletons" /></p> <p>以 Å (<em>U+212B</em>, 埃符號) 來說，如果要轉換成 NFD 形式，會透過標準化的拆解演算法，分成 A (<em>U+0041</em>, 拉丁字母 A) 及 ◌̇ (<em>U+030A</em>, 上方圈圈) 兩個部件。<br /> 如果要轉換成 NFC 形式的話，則會先經過 NFD 程序，再透過標準化組裝得到 Å (<em>U+00C5</em>, 帶有上方圈圈 A 字母)，而不是原本的 Å (<em>U+212B</em>, 埃符號)。</p> <p>以 Ω (<em>U+2126</em>, 歐姆符號) 而言，經過 NFD 拆解演算法會找到相同字面的標準形式 Ω (<em>U+03A9</em>, 希臘字母 Omega)，此範例中 NFC 等於 NFD。</p> <p>上面兩個例子可被歸於 Singletons 類別，經過標準化後非標準的字碼會直接被標準字碼取代，不會被保留。</p> <h2 id="combining-marks">Multiple Combining Marks 多種組合標記</h2> <p>有些文字像 Ṩ 是 S 加上兩個標記符號，同一個字面也可以有多種排列組合方式<br /> （共有 Ṩ、Ṡ + ◌̣、Ṣ + ◌̇、S + ◌̇ + ◌̣、S + ◌̣ + ◌̇ 五種）</p> <p><img src="https://unicode.org/reports/tr15/images/UAX15-NormFig5.jpg" alt="Figure 5. Multiple Combining Marks" /></p> <p>在經過 NFD 拆解後，除了將字母本體放在前面外，後面的 ◌̣ 跟 ◌̇ 也會用唯一的順序排列，保證同一串文字在經過 NFD 拆解後可以取得唯一的結果。</p> <p>而用 NFC 形式在標準化組裝時，第一個例子因為有 ṩ 可以用（並且不在例外清單中），就直接用 <em>U+1E69</em> 單個字碼表示。<br /> 第二個例子無法用單字元表示 ḍ̇，因此在 ḍ + ◌̇ 與 ḋ + ◌̣ 之間選擇標準化的版本，以保證每次得出相同結果。<br /> 第三個例子則是因為 Unicode 字碼表內不包含 q̣ 或 q̇ 字元，因此 NFC 形式與 NFD 形式相同。</p> <h2 id="compatibility-composites">Compatibility Composites 相容性組合</h2> <p>前面講到了 NFD 及 NFC 兩種形式，都是使用「標準化拆解」，這邊 NFKD 及 NFKC 是使用「相容性拆解」。</p> <p><img src="https://unicode.org/reports/tr15/images/UAX15-NormFig6.jpg" alt="Figure 6. Compatibility Composites" /></p> <p>第一個例子中，原本連字的 ﬁ 變回了 f + i 兩個字母；第二個例子把 2⁵ 的上標屬性還原，變回純數字 25。</p> <p>在第三個例子中，ẛ + ◌̣ 經過相容性拆解後，把 ſ (<em>U+017F</em>, 拉丁小寫長版 s 字母) 變回了 s；而 NFKC 是先做相容性拆解，再做標準化組合（而不是拿 NFC 做相容性處理），因此得到單個 ṩ 而不是 ṡ + ◌̣。</p> <h2 id="nf-summary">小結</h2> <p>NFD 是 Canonical Decomposition 標準化拆解，將音標、組字拆開，再按照一套特定方法排序。</p> <p>NFC 在官方文件中的定義是 Canonical Decomposition, followed by Canonical Composition，也就是先做 NFD 拆解後再組合，而不是一步到位。</p> <p>而 NFKD 及 NFKC 的 K 是 Compatibility（相容性）的縮寫，會將「𝒮𝕥r𝔞𝐧g𝘦」轉換成「Strange」，得到的文字可能會長得和原文不一樣。</p> <p>「o ﬃ c e」經過 NFD / NFC 轉換不會變，但經過 NFKD / NFKC 會變成「o f f i c e」；而「o f f i c e」經過 NFD / NFC / NFKD / NFKC 標準化都還是一樣，不會把 f f i 變成連字的 ﬃ。</p> <h1 id="solution">解決方法</h1> <p>在經過 <a href="https://github.com/splitline">@splitline</a> 指點後，得知 PHP 有內建一個函式可以完美解決這個問題。只要在需要過濾使用者輸入的地方加上 <code class="language-plaintext highlighter-rouge">Normalizer::normalize($text);</code> 函式，就能用 NFC 或指定的格式來標準化，讓位於其他區段的罕用字碼回到正常的常用字碼。</p> <p>在各主流語言中也有相應的解法，例如 Python 的 <a href="https://docs.python.org/3/library/unicodedata.html#unicodedata.normalize">unicodedata.normalize()</a>、JavaScript 的 <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/normalize">String.prototype.normalize()</a>。</p> <h1 id="confusables">延伸閱讀 1：Confusables 易混淆字元</h1> <p>在研究這個問題的前期，我循線找到了 <a href="https://github.com/unicode-org/icu">unicode-org/icu</a> 這份 Repo，ICU 專案全名是 International Components for Unicode，包含 C/C++ 與 Java 的版本，裡面有許多 Unicode 相關字串處理的函式。</p> <p>其中 <a href="https://github.com/unicode-org/icu/blob/main/icu4c/source/data/unidata/confusables.txt">confusables.txt</a> 讓我覺得很有趣，例如「𝟑 𝟛 𝟥 𝟯 𝟹 Ɜ Ȝ Ʒ Ꝫ Ⳍ З Ӡ 𖼻 𑣊」都會變成 3。</p> <p>而某些字面相同/類似的文字，甚至會出現三四次：</p> <blockquote> <p>⼒ (<em>U+2F12</em>, 康熙部首 Power) → 力 (<em>U+529B</em>, 中日韓統一表意文字)<br /> カ (<em>U+30AB</em>, 片假名 Ka) → 力 (<em>U+529B</em>, 中日韓統一表意文字)<br /> 力 (<em>U+F98A</em>, 中日韓相容性表意文字) → 力 (<em>U+529B</em>, 中日韓統一表意文字)</p> </blockquote> <p>但 confusables 不像 NFC 標準化只轉換長得一樣的字元，也不像 NFKC 轉換到意義上的標準字樣，而是以視覺上相似的常用字元為主：</p> <blockquote> <p>ſ (<em>U+017F</em>, 拉丁小寫長版 s 字母) → f (<em>U+0066</em>, 小寫拉丁字母)<br /> ք (<em>U+0584</em>, 亞美尼亞 Keh 字母) → f (<em>U+0066</em>, 小寫拉丁字母)<br /> 𝒇 (<em>U+1D487</em>, 粗斜體數學字母) → f (<em>U+0066</em>, 小寫拉丁字母)</p> </blockquote> <h1 id="unicode-diff">延伸閱讀 2：Unicode、UTF-8 差異</h1> <p>這是我困惑了好幾年的問題，以前都把兩個詞混著用，前陣子仔細查過才發現之間差異，因此寫進本文附錄。</p> <h2 id="unicode">Unicode 統一碼</h2> <p>以往台灣用 Big5，簡體用 GB 2312，各語系有自己的一套字元集，資訊流通起來就很不方便，因此有人提出包含所有語系文字、全球都通用的 Unicode 字元集。</p> <p>在 Unicode 這個字元集中，「你好」可以被表示為「<em>U+4F60</em>, 漢字 you, second person pronoun」跟「<em>U+597D</em>, 漢字 good, excellent, fine; well」兩個字碼；其中 <em>U+XXXX</em> 就是 Unicode 字碼的表示形式，在 Unicode 文件中也會說到這個字碼是「漢字」，代表著什麼意義；而我們平常看到「文字」，則是由字體檔告訴電腦，什麼字碼該呈現什麼圖形。</p> <p>又例如表情符號「🤪」字碼為 <em>U+1F92A</em>，代表「眼睛一大一小的笑臉」，各家廠商（如 Apple, Google, Twitter, Samsung）再依照自家的風格指南，繪製成 <a href="https://emojipedia.org/zany-face/">我們看到的樣子</a>。</p> <h2 id="utf-32">UTF-32、UTF-16 編碼</h2> <p>在 Unicode 規範中，從 <em>U+0000</em> 到 <em>U+10FFFF</em> 都是有效的字碼，因此如果直接轉換每個字碼到 4 位元組的空間，對程式來說很好實作，這種做法稱作 UTF-32 編碼。</p> <p>由於多數常用字元都被編排在 <em>U+0000</em> - <em>U+FFFF</em> 區段，而規範中又保證 <em>U+D800</em> - <em>U+DFFF</em> 不會對應到任何字元，因此有人想到可以先把所有 Unicode 都嘗試用 2 個位元組表示。遇到 <em>U+10000</em> - <em>U+10FFFF</em> 區段時，再改用 2 個 <em>U+D800</em> - <em>U+DFFF</em> 之間的字元（4 個位元組）來表示。</p> <p>雖然 UTF-32、UTF-16 對程式來說編寫起來很直覺，但無法與 ASCII 編碼相容。即使已知某文字檔只包含 ASCII 字元，對於不相容於 Unicode 的程式來說，可能會因為每個字之間的 NULL 導致無法正常顯示；對於許多以 NULL 作為結尾的語言，甚至連單純的字串複製都無法達成。</p> <p>假如在不知情的狀況下將 UTF-16 誤作為 ASCII 編碼解讀，就會把「子丑寅卯」解讀為「[PN�[�So」，在某些剛好有定義的字元下，看到時很難斷言這是 UTF-16、ASCII 或其他編碼。</p> <h2 id="utf-8">UTF-8 編碼</h2> <p>而 UTF-8 編碼算是解決了這個問題，下圖節錄自維基百科，可以看到 ASCII 範圍的 <em>U+0000</em> - <em>U+007F</em> 只用了 1 個位元組；而 <em>U+0080</em> 開始，編碼後每個位元組的第一個位元都是 1，即使當成 ASCII 編碼檢視也不會產生歧義。</p> <p><img src="https://img.sean.taipei/2021/12/utf-8.jpg" alt="Code point <-> UTF-8 conversion" /></p> <p>另外蠻巧妙的一點是，後續每個位元組都是 <code class="language-plaintext highlighter-rouge">10xxxxxx</code>，第一個位元組則依照字碼長度不同，讓程式從中間讀取字串時，不管是向前或向後尋找字元邊界，都能快速準確的知道該從哪裡切割。</p> <p>順帶一提，複製網址時常看到的 <code class="language-plaintext highlighter-rouge">%E7%B6%AD%E5%9F%BA%E7%99%BE%E7%A7%91</code> 就是中文的 UTF-8 編碼加上 <a href="https://zh.wikipedia.org/wiki/URL%E7%B7%A8%E7%A2%BC" title="Wiki [[URL編碼]]">URL Encoding</a>，大多數中文字位於 <em>U+0800</em> - <em>U+FFFF</em> 範圍內，因此佔 3 個位元組，編碼後 <code class="language-plaintext highlighter-rouge">%E7%B6%AD</code>、<code class="language-plaintext highlighter-rouge">%E5%9F%BA</code>、<code class="language-plaintext highlighter-rouge">%E7%99%BE</code>、<code class="language-plaintext highlighter-rouge">%E7%A7%91</code> 各代表一個中文字。</p> <h2 id="unicode-summary">小結</h2> <p>Unicode 是字元集，其範圍從 <em>U+0000</em> 到 <em>U+7FFFFFFF</em>，對我而言算是一個抽象的定義，各個字碼定義了每個「字」的意義、基本形狀，讓字體設計師賦予其活力。<br /> 而 UTF-8 是一種 Unicode 的編碼，將 <em>U+XXXX</em> 轉換成 1 - 4 個位元組，讓電腦得以儲存、傳輸。</p> <p>使用 Unicode 字元集時，不一定要是哪種編碼，在 Unicode、UTF-8、UTF-16、UTF-32 之間可以用數學方式轉換。<br /> 在討論 UTF-8、UTF-16、UTF-32 編碼時，用的都是 Unicode 字元集；如果要在 Unicode 與 Big5 或 GB 2312 等字元集之間轉換，則需要有一對一（或多對一）的轉換對照表。</p> <h1 id="epilogue">後記</h1> <p>最開始研究時，大家們發現那些看起來正常卻又印不出來的字，只看到 KANGXI RADICAL 康熙部首區段、CJK RADICAL 中文部首區段、CJK COMPATIBILITY IDEOGRAPH 中日韓相容性字元區段，覺得是亂碼。<br /> 但根據經驗、實測，瀏覽器 Ctrl-F 搜尋功能又能正確識別出這些文字，因此就從 Firefox 的原始碼 <a href="https://github.com/mozilla/gecko-dev">mozilla/gecko-dev</a> 開始找起，發現裡面有一份 <code class="language-plaintext highlighter-rouge">confusables.txt</code>。之前 fork 某專案開發時也看過 ICU 相關資料集，因此回去找了正確的上游 Repo，並稍為了解其意義。</p> <p>原本打算寫成一個 PHP 套件，讓內部專案可以直接 composer install 利用的，但朋友 <a href="https://github.com/splitline">@splitline</a> 從 GitHub 動態看到我開一個新的 Repo，就跟我分享 PHP 內建的標準化函式，讓我不用重造輪子 XD 在研究完前因後果、經過組內報告後，為了撰寫相關文件頁面，就生出這篇部落格文整理思緒了，希望多少能幫到幾位踩雷的有緣人。</p> <p>本文撰寫期間麻煩了很多朋友協助校稿，特別感謝 <a href="https://xdavidwu.link/">xdavidwu</a>、<a href="https://thect.cc/">Thect</a>、<a href="https://github.com/psychicalcoder">Marvin Liu</a>、<a href="https://blog.staque.xyz/">Cycatz</a>、<a href="https://github.com/Alan-Kuan">Alan Kuan</a> 提供寶貴的意見，在討論思辨的過程中，讓這篇文章更精確的傳達科普知識。</p> <p>本文同步分享於 <a href="https://t.me/SeanChannel/100" target="_blank">Telegram</a>、 <a href="https://twitter.com/Sea_n64/status/1469157426956222465" target="_blank">Twitter</a>、 <a href="https://www.facebook.com/Sean0604/posts/3079699862301852" target="_blank">Facebook</a>，如果有什麼想法，都歡迎來留言區交流。</p> <h1 id="references">References 參考資料</h1> <ul> <li>Unicode UAX #15 標準附錄：<a href="https://unicode.org/reports/tr15" title="Unicode Standard Annex #15">unicode.org</a></li> <li>Confusable 易混淆字元：<a href="https://github.com/unicode-org/icu/blob/main/icu4c/source/data/unidata/confusables.txt">unicode-org/icu</a></li> <li>Unicode 字碼資訊：<a href="https://www.fileformat.info/info/unicode/char/597D/index.htm">fileformat.info</a></li> <li>維基百科：<a href="https://zh.wikipedia.org/wiki/Unicode">Unicode</a>、<a href="https://zh.wikipedia.org/wiki/UTF-8">UTF-8</a>、<a href="https://zh.wikipedia.org/wiki/Unicode%E5%8D%80%E6%AE%B5">Unicode 區段</a>、<a href="https://zh.wikipedia.org/wiki/%E5%AD%97%E5%85%83%E7%B7%A8%E7%A2%BC">字元編碼</a></li> </ul> <style> em { color: darkviolet; font-style: normal; } </style>

2021/12/10

Telegram 官方關於 TON 區塊鏈及 Gram 幣的公開聲明

<h1 id="關於-ton-區塊鏈及-gram-幣的公開聲明">關於 TON 區塊鏈及 Gram 幣的公開聲明</h1> <p><span class="orig">A Public Notice About the TON Blockchain and Grams</span></p> <p>您可能已經聽說，自 <strong>2017</strong> 以來，Telegram 團隊一直在開發一個名為 <strong>TON Blockchain</strong> 的新區塊鏈平台和名為 <strong>Gram</strong> 的加密貨幣。我們希望這個專案能讓 Gram 成為傳統貨幣的互補品，從而改善全球日常商業交易的 <strong>速度</strong>、<strong>效率</strong> 和 <strong>安全性</strong>。我們相信，TON 區塊鏈技術將創造一個穩定的生態系統，並且在 <strong>速度</strong>、<strong>可用性</strong> 和 <strong>可擴展性</strong> 方面都將比以前的平台有重大改進。</p> <p><span class="orig">You may have heard that since <strong>2017</strong> the team at Telegram has been developing a new blockchain platform called the <strong>TON Blockchain</strong> and native cryptocurrency called <strong>Grams</strong>. We hope that as a result of this project Grams will become a true complement to traditional currencies, improving the <strong>speed</strong>, <strong>efficiency</strong> and <strong>security</strong> of everyday commercial transactions globally. We believe that the TON Blockchain technology will create a stable ecosystem and represents a significant improvement upon previous platforms in terms of <strong>speed</strong>, <strong>usability</strong> and <strong>scalability</strong>.</span></p> <p>媒體上有很多關於這個專案細節的謠言與臆測，在我們繼續構建 TON 區塊鏈平台並確定專案的確切細節以確保 TON 區塊鏈和 Gram 幣可以用 <strong>符合</strong> 法律及規範的方式運作的同時，Telegram 一直謹慎地 <strong>避免公開談論</strong> 這些謠言。</p> <p><span class="orig">There have been a lot of rumors in the media and speculation about the details of this project. Telegram has been careful <strong>not to speak publicly</strong> about these rumors while we continue to build the TON Blockchain platform and work out the exact details of the project to ensure that the TON Blockchain and Grams can operate in a way that is <strong>compliant</strong> with all relevant <strong>laws and regulations</strong>.</span></p> <p>鑑於最近發生的事件，我們希望花點時間公開闡明 TON 區塊鏈和 Gram 幣的某些面向，同時我們將繼續為專案的成功啟動做準備。</p> <p><span class="orig">In light of recent events, we wanted to take the time to publicly clarify certain aspects of the TON Blockchain and Grams as we continue to prepare for a successful launch of the project.</span></p> <blockquote> <p>我們在本文的段落中將以 <strong>簡單的術語</strong> 做簡短的 <strong>摘要</strong>，格式會像是這樣 👈</p> <p><span class="orig">We’ve included short <strong>summaries</strong> in <strong>simple terms</strong> for paragraphs in this text, formatted like this 👈</span></p> </blockquote> <h2 id="目前還沒人可以買賣-gram-幣">目前還沒人可以買賣 Gram 幣</h2> <p><span class="orig">Nobody can buy or sell grams yet</span></p> <p>首先，引起我們注意的是某些網站似乎向公眾提供了 Gram 幣。這些網站有時將此稱為「貨幣預售」，有些則假裝與 Telegram 相關。正如我們在 <a href="https://twitter.com/durov/status/944360557318205440">很多</a> <a href="https://t.me/telegram/118">地方</a> 上警告您一樣，這些都 <strong>不是</strong> Telegram 的官方網站，它們與 Telegram <strong>沒有</strong> 隸屬關係，並且 Gram 幣 <strong>尚未</strong> 向任何人發行。Telegram 或其相關公司均未參與 Gram 幣的任何公開銷售或預售。相反地，乘載 Gram 幣的 TON 區塊鏈仍處於 <strong>Beta 測試</strong> 階段，您可以於 <a href="https://test.ton.org/download.html">test.ton.org</a> 造訪 Beta 測試網站，只有在 TON 區塊鏈啟動後，Gram 幣才會被創造並開放購買。</p> <p><span class="orig">First, it has come to our attention that certain websites appear to be offering Grams to the public. These websites sometimes refer to the offers as “token presales,” and some pretend to be affiliated with Telegram. As we’ve warned you on <a href="https://twitter.com/durov/status/944360557318205440">numerous</a> <a href="https://t.me/telegram/118">occasions</a>, these are <strong>NOT</strong> official Telegram websites, they have <strong>NO</strong> affiliation with Telegram, and <strong>NO</strong> Grams have been issued yet to anyone. Neither Telegram nor any of its affiliates are involved in any public sales or presales of Grams. To the contrary, the TON Blockchain on which Grams will function is still in a <strong>Beta Test</strong> phase and you can access the Beta Test website at <a href="https://test.ton.org/download.html">https://test.ton.org/download.html</a>. Only once the TON Blockchain launches will Grams be created and available to purchase.</span></p> <blockquote> <p><strong>長話短說：</strong> Gram 幣還不存在，<strong>沒有人</strong> 有辦法在我們宣布推出 TON 區塊鏈前做任何買賣。 <strong>別受騙了</strong></p> <p><span class="orig"><a href="https://www.urbandictionary.com/define.php?term=tl%3Bdr"><strong>TLDR:</strong></a> Grams don’t exist yet, <strong>nobody</strong> can buy or sell them before we announce the launch of TON Blockchain. <strong>Don’t get scammed.</strong></span></p> </blockquote> <h2 id="ton-區塊鏈將是去中心化並由第三方維護">TON 區塊鏈將是去中心化並由第三方維護</h2> <p><span class="orig">TON will be decentralized and maintained by third parties</span></p> <p>其次，如果您正在考慮在 TON 區塊鏈平台啟動後是否該購買 Gram 幣，我們希望您了解幾件事。Telegram 及相關公司並未對 TON 區塊鏈開發任何應用程式或功能作出任何承諾。實際上，Telegram 可能永遠不會這樣做。相反地，Telegram 的目標是希望 <strong>各地的第三方開發人員社群</strong> 和其他人員將透過開發應用程式及智能合約為 TON 生態系做出貢獻。<strong>第三方</strong> 和社群將以自己選擇的方式採用 TON 區塊鏈和實施此類應用程式或智能合約，這責任只存在於第三方。Telegram 不會也不能保證任何人將在任何給定的時間表上實現，或根本不採用此類功能提供服務。</p> <p><span class="orig">Second, if you are considering whether to purchase Grams once the TON Blockchain platform is launched, we want you to know certain things. Telegram and its affiliates have not made any promises or commitments to develop any applications or features for the TON Blockchain or otherwise contribute in any way to the TON Blockchain platform after it launches. In fact, it is possible that Telegram may never do so. Rather, it is Telegram’s goal and hope that the <strong>decentralized community of third-party developers</strong> and others will contribute to the TON ecosystem through the development of applications and smart contracts. It will be the sole responsibility of <strong>third parties</strong> and the community to adopt and implement such applications or smart contracts on the TON Blockchain in the manner they choose. Telegram does not, and cannot, guarantee that anyone will adopt or implement such features or provide such services, on any given timetable or at all.</span></p> <blockquote> <p><strong>長話短說：</strong> 我們為所有人建立了 <strong>去中心化</strong> 的平台，當他發布後 Telegram 不再有義務維護平台或為此建立任何應用程式，或說我們根本不會這麼做。</p> <p><span class="orig"><strong>TLDR:</strong> We are creating a <strong>decentralized</strong> platform for everyone. Once it launches, Telegram won‘t be obligated to maintain the platform or create any apps for it. It’s possible we never will.</span></p> </blockquote> <h2 id="telgram-將無權控制-ton-區塊鏈">Telgram 將無權控制 TON 區塊鏈</h2> <p><span class="orig">Telegram will have no control over TON</span></p> <p>TON 區塊鏈的程式碼將始終 <strong>開源</strong> 且任何人 <strong>皆可取得</strong>，一旦推出後 Telegram 將與 TON 區塊鏈的 <strong>其他任何人</strong> 站在 <strong>相同的地位</strong>，並將 <strong>無權控制</strong>、沒有任何特權、不負對 TON 區塊鏈管理的任何責任。</p> <p><span class="orig">The code for the TON Blockchain will always be <strong>open source</strong> and <strong>publicly viewable</strong>. Once it is launched, Telegram will occupy the <strong>same position</strong> as <strong>any other party</strong> with respect to the TON Blockchain and <strong>will not have any control</strong> over, any unique rights within, or any responsibility for the management of, the TON Blockchain.</span></p> <p>在 TON 區塊鏈推出後，Telegram 或其員工可以但不保證持有任何 Gram 幣。在一定程度上，他們將 <strong>不參與跟 TON 區塊鏈有關的表決或驗證</strong>。做出此自願性決定是為了避免任何人認為 Telegram 及其員工可以或將在 TON 區塊鏈發布後對其實施控制。</p> <p><span class="orig">Telegram or its employees may, but do not commit to, hold any Grams following the launch of the TON Blockchain. To the extent they do, they will <strong>not take part in voting or validating</strong> in connection with the TON Blockchain. This voluntary decision was made in order to avoid any perception that Telegram or its employees can or will exercise control over the TON Blockchain following its launch.</span></p> <blockquote> <p><strong>長話短說：</strong> 在推出後 Telegram 將無法控制 TON 區塊鏈及其生態系統。就像建築師設計摩天大樓一樣，建築師無法控制建築物完工後發生的情況 - 包括周圍的建築物、內部裝潢，或頂樓加蓋。</p> <p><span class="orig"><strong>TLDR:</strong> Telegram won‘t be able to control the blockchain and the ecosystem after it launches. Pretty much like an architect who designed a skyscraper can’t control what happens with the building after it’s finished – including what gets built around, inside or on top of it.</span></p> </blockquote> <h2 id="炒-gram-幣並不能讓您致富">炒 Gram 幣並不能讓您致富</h2> <p><span class="orig">Grams won’t help you get rich</span></p> <p>第三，您不應該基於期望獲利而購買 Gram 幣，Telegram 不做任何您能獲利的保證。Gram 幣旨在充當 TON 生態系統中用戶之間的 <strong>交換媒介</strong>，Gram 幣並 <strong>不是</strong> 投資產品，對於從 Gram 幣的買賣或持有中獲利您應該 <strong>不抱</strong> 任何期望。</p> <p><span class="orig">Third, you should <strong>NOT</strong> expect any profits based on your purchase or holding of Grams, and Telegram makes no promises that you will make any profits. Grams are intended to act as a <strong>medium of exchange</strong> between users in the TON ecosystem. Grams are <strong>NOT</strong> investment products and there should be <strong>NO</strong> expectation of future profit or gain from the purchase, sale or holding of Grams.</span></p> <p>Gram 幣並 <strong>不</strong> 代表：</p> <ul> <li>Telegram 及其相關公司的任何股權或所有權利益</li> <li>Telegram 或其相關公司的股息或其他分配權</li> <li>Telegram 或其相關公司的任何管理權</li> </ul> <p><span class="orig">Grams do <strong>NOT</strong> represent:</span></p> <ul> <li><span class="orig">Any equity or other ownership interest in Telegram or its affiliates</span></li> <li><span class="orig">Any rights to dividends or other distribution rights from Telegram or its affiliates</span></li> <li><span class="orig">Any governance rights in Telegram or its affiliates.</span></li> </ul> <blockquote> <p><strong>長話短說：</strong> 如果您在將來購買 Gram 幣，這 <strong>不代表</strong> 您持有 Telegram 的一部分，Gram 幣並不會賦予其持有者任何特殊權利，就像持有歐元不會給您歐盟的股份一樣。</p> <p><span class="orig"><strong>TLDR:</strong> If you buy grams at some point in the future, this <strong>won’t</strong> mean you “own a piece of Telegram.” Grams don‘t give their holders any special rights, just like owning Euros doesn’t give you shares in the European Union.</span></p> </blockquote> <p>在決定是否購買 Gram 幣時，您應該充分意識到 Gram 幣的價值可能會隨著時間的流逝而下降甚至失去 <strong>所有貨幣價值</strong> 的風險。購買諸如 Gram 幣之類的加密貨幣存在許多風險，包括加密貨幣市場的波動性、對交易所的監管加嚴的可能性以及其他風險。</p> <p><span class="orig">In deciding whether to purchase Grams, you should be fully aware of the risk that Grams may decrease in value over time or even lose <strong>all monetary value</strong>. There are a number of risks related to purchasing cryptocurrencies like Grams, including volatility in cryptocurrency markets, the possibility of increasing regulation of cryptocurrency exchanges and other risks.</span></p> <blockquote> <p><strong>長話短說：</strong> 玩加密貨幣是 <strong>高風險地</strong>，由於一卡車的外在因素，實際上可能讓您變得更窮。</p> <p><span class="orig"><strong>TLDR:</strong> Dealing with cryptocurrency is <strong>risky</strong> and can actually make you poorer than you are due to a boatload of external factors.</span></p> </blockquote> <h2 id="而假如您已經聽過-ton-區塊鏈">而假如您已經聽過 TON 區塊鏈…</h2> <p><span class="orig">And if you already heard about TON…</span></p> <p>最後，我們想提供有關 TON 區塊鏈的某些技術和治理方面的進一步說明。請注意，以下內容旨在 <strong>取代和替換</strong> 與 TON 區塊鏈和 Gram 幣有關的所有先前文章，以免發生任何衝突或潛在衝突，包括 TON 白皮書或 Telegram 及其他人在任何先前版本中規定的資訊和詳細訊息：</p> <p><span class="orig">Finally, we wanted to provide further clarity regarding some technical and governance aspects of the TON Blockchain. Please note that the below is intended to <strong>supersede and replace</strong> all prior materials or communications regarding the TON Blockchain and Grams to the extent of any conflict or potential conflict, including the information and details set forth in the TON Whitepapers or any previous communications or materials by Telegram or anyone else:</span></p> <p><strong>(1)</strong> Telegram 沒有義務，也沒有做出任何承諾，以後不會建立 <strong>TON 基金會</strong> 或類似機構。</p> <p><span class="orig"><strong>(1)</strong> Telegram is under no obligation, and makes no promise or commitment, to ever establish a <strong>TON Foundation</strong> or similar entity in the future.</span></p> <p><strong>(2)</strong> 在預期推出 TON 區塊鏈時，Telegram 的 TON 錢包應用程式預計將以 <strong>獨立</strong> 的方式單獨提供，並且不會與 Telegram Messenger 服務整合。在這方面，TON 錢包有望與 <strong>第三方</strong> 提供的任何其他錢包應用程式 <strong>競爭</strong>。在適用法律和政府機構允許的前提下，Telegram Messenger 將來可能會內建整合 TON 錢包功能。</p> <p><span class="orig"><strong>(2)</strong> At the time of the anticipated launch of the TON Blockchain, Telegram’s TON Wallet application is expected to be made available solely on a <strong>stand-alone basis</strong> and will not be integrated with the Telegram Messenger service. In this regard, the TON Wallet is expected to <strong>compete</strong> with any other wallet applications designed and offered by <strong>third parties</strong>. Telegram may integrate the TON Wallet application with the Telegram Messenger service in the future to the extent permitted under applicable laws and governmental authorities.</span></p> <p>Telegram 保留所有進一步增加、澄清或修改 TON 區塊鏈或 Gram 幣以上及任何其他方面的權利。隨著 TON 區塊鏈預定發布日期的接近，我們期待提供更多訊息。</p> <p><span class="orig">Telegram reserves all rights to further add to, clarify or revise these or any other aspects of the TON Blockchain or Grams. We look forward to providing more information as we get closer to the anticipated launch of the TON Blockchain.</span></p> <p><em>January 6, 2020<br /> The Telegram Team</em></p> <hr /> <p><em>本文章包含前瞻性陳述，包括計劃、目標、期望、發展狀況，以及意圖。任何數量的因素都可能導致實際結果與任何前瞻性陳述所預期的結果產生重大差異，包括但不限於此處確定的風險。</em></p> <p><span class="orig"><em>This communication contains forward-looking statements, including statements of plans, objectives, expectations, development status and intentions. Any number of factors could cause actual results to differ materially from those contemplated by any forward-looking statements, including but not limited to the risks identified herein.</em></span></p> <h2 id="譯註">譯註</h2> <p>以上僅是簡單翻譯，如有錯誤或任何建議還請 <a href="https://t.me/SeanTalk">不吝指教</a></p> <p>原文請見 <a href="https://telegram.org/blog/ton-gram-notice">官方部落格</a></p> <p>如感興趣可以來 <a href="https://t.me/PublicGroupForZH">Telegram 討論區</a> 逛逛</p> <p>譯者：<a href="https://t.me/SeanChannel/94">Sean Wei</a><br /> 轉載/節錄請註明來源出處</p> <style> blockquote { color: black; border-left-color: #179cde; } .orig { color: grey; } </style>

2020/1/6

交大資工開學經歷

<p>大學是個新的起點，很開心覺得自己過得還算充實，寫個心情紀錄給自己，只是有點流水帳</p> <h1 id="sep-2-mon">Sep 2 (Mon)</h1> <p>早上八點整理出門，先跟爸爸去新竹工地，媽媽再載我到交大</p> <h2 id="宿舍入住">宿舍入住</h2> <p>早上十點抵達宿舍，辦完入住手續後搬了一大箱行李、床墊到房間</p> <p>中午從研三騎 YouBike 滑行下去清大小吃部找 William 跟他的兩位同學</p> <p>吃完飯到禮齋，在走廊上剛好遇到國中同學愷峰</p> <h2 id="選課">選課</h2> <p>從三點開始，我跟 Alan、lys 三人一起選課，先是完全打不開加選頁面，後來才發現是因為網頁檔名叫 <code class="language-plaintext highlighter-rouge">adMain.asp</code> 所以被 uBlock origin 阻擋</p> <p>一開始在系統和 NCTU+ 做模擬排課，但後來發現太過於複雜無法消化，改用紙筆規劃不衝堂的排課方式</p> <p>在糾結和取捨了多次之後，到六點終於完成課程初選了，等待 9/6 公佈結果</p> <h1 id="sep-3-tue">Sep 3 (Tue)</h1> <p>床旁邊就是整面的窗簾，六點就被陽光叫起來了，或許這週回家補給時該買個眼罩</p> <h2 id="開學典禮">開學典禮</h2> <p>各組上台宣達新生事務，多數人在滑手機，我則是直接拿筆電架、電腦出來用</p> <p>中午吃完飯後，趁禮堂人還不多，找了十多個資工系同學小聊一下，多數人對資訊是有興趣的，但許多人程式都是只會基礎，或是進來才要開始學</p> <p>下午兩點休息時間，去百川的座位上找同樣會程式的何孟軒，了解當時進入主要的長才、也簡單認識周圍其他百川的同學，真的很好奇/羨慕這群同學，在一個系裡面各有不同興趣專長，約好有機會再吃個飯慢慢聊</p> <h2 id="計中工讀">計中工讀</h2> <p>清水救生隊的 Vincent 教練知道我錄取交大後，介紹了一位諮詢服務組 Sophi 給我認識，這天中午去資訊技術服務中心第一次見面，聊了一小時後順便帶我上去二樓，找校務資訊組黃世昆老師</p> <p>沒想到與黃老師第一次見面，就跟我說待會下午四點有 SQLab 軟體品質實驗室的 meeting，邀請我可以讓我過去晃晃</p> <h2 id="sqlab">SQLab</h2> <p>五點新生活動結束後，跟 Jasper 一起去 EC129 找黃老師，一進去就熱情的招待豆花、飲料</p> <p>裡面大概十位碩班的學長，這次報告的大概是講 Machine Learning 利用雜訊 Retrain 增加 Accuracy，之前就有碰過一點基礎的機器學習，大概理解方法後也去找報告者討論一下，沒想到 AIS3 課程教的知識可以在這時候派上用場</p> <p>跟大家聊一聊後，黃老師也表示歡迎下課時間過去那邊坐坐、有問題可以問學長們</p> <h2 id="機櫃裝系統">機櫃裝系統</h2> <p>晚上八點跟 Jasper、William 去 ED9xx 的機櫃，有一個是放 Jasper 在上次綠界活動拿到的 Rack Server</p> <p>過去時已經都放上機架了，這次幫忙裝 PVE 系統，從設定網路、設定 RAID 卡，到安裝系統</p> <p>八台 server 只用先用了四台，到了十二點半結束，分開後自己去便利商店吃完晚餐再回宿舍</p> <h1 id="sep-4-wed">Sep 4 (Wed)</h1> <p>第二天的新生活動，除了上下午簽到外，中間休息還會「抽獎」防止偷跑</p> <p>上午寫心得及回信，原本還想說有時間看個影片，但筆電用到快沒電，也只能作罷</p> <p>中午回到研三舍，配 Netflix 的越獄風雲吃對面買的義大利麵</p> <p>下午帶了充電器到禮堂，才發現根本找不到插座</p> <h2 id="自助洗衣">自助洗衣</h2> <p>晚上洗好澡後把三天份的衣服一起拿去洗，看著單槽洗衣機跟洗衣精包裝上的指示猶豫了很久，不知道該加多少，還好最後衣服洗出來感覺還不錯</p> <p>回到宿舍後叫了外送宵夜來吃，大概 15 分鐘送到了，效率還不錯，熱熱的也很好吃</p> <p>放了一小時才想到要去拿，看到隔壁烘衣間每台都有人在用了，沒看清楚標示就把洗好的衣服放到滾筒式洗衣機去了，按下開始後就鎖起來了，找不到停止鈕</p> <p>洗完兩次衣服、烘乾後，發現每件都還濕濕的，或許下次要改投 20 元烘一小時</p> <p>還好拿回房間晾一個晚上，隔天起來就全乾了</p> <h1 id="sep-5-thu">Sep 5 (Thu)</h1> <p>前兩天都要八點起床，今天下午一點才有活動，終於可以睡飽一點了</p> <p>但還是九點就被太陽亮醒，今早注意看才發現應該是窗簾太透光的問題</p> <h2 id="新生報到">新生報到</h2> <p>到交大前是覺得全系 180 人要把系群從 LINE 搬到 Telegram 太困難，不打算這麼做</p> <p>個別聊了一下發現竟然有人在 <a href="https://t.me/TelegreatX">Telegreat 群</a> 裡面，就重新覺得既然都資訊人，用 TG 才是常態，重新燃起推坑熱情</p> <p>原本是說入學通知單作為開學後十天內的正式證件，沒想到這麼快就拿到學生證了，比起普通的新北市高中學生證，覺得這張真的很美，尤其特別喜歡雷射校徽</p> <h2 id="游泳">游泳</h2> <p>今天整天下雨，晚上覺得整天沒什麼動到悶悶的，就自己跑去泳池</p> <p>交大的室外池有八個水道，是 50 公尺的大池，泳客大約 15 人空曠又不孤單，水質也不錯，只可惜深度就普通的 1.3 米而已</p> <p>上次游泳是 SITCON 夏令營 Day -1 的早上了，整整一個月沒碰到水，果然單趟就會累了，自己複習一下各種泳姿，玩了半小時就回去宿舍休息</p> <p>晚上找 William 來宿舍，外送滷味 3 人一起吃，意外開始被推 Blender 坑，看到 <a href="https://www.youtube.com/watch?v=WhWc3b3KhnY">Blender Open Movie</a> 真的一時難以相信，一個是這電影竟然是動畫、開源軟體製作的動畫，一方面在想電影怎麼開源、除了放出專案檔可以怎麼做</p> <h1 id="後記">後記</h1> <p>再不到一週就要正式開學了，希望大學除了學到各種知識常識外，可以順利讀完，很怕選太多課反而害到自己</p> <p>原本是想記錄一週或一個月再發，但看到美美的學生證就忍不住先發了，結尾再放一次海豹照片</p> <p><img src="https://img.sean.taipei/2019/09/nctu-seal-card.jpg" alt="" /></p>

2019/9/5

Sean's Note

Robust UDP Challenge - 網路程式設計概論

交大資工所 推甄紀錄 韋詠祥

ICANN75 - 吉隆坡之旅

ICANN75 - Trip to Kuala Lumpur

Kubernetes 網站貢獻心得

來迺陽明交大水所在 陽交校慶系列活動

CEH v11 證照考試心得

Unicode Normalization 文字標準化

Telegram 官方關於 TON 區塊鏈及 Gram 幣的公開聲明

交大資工開學經歷

交大資工所推甄紀錄韋詠祥

來迺陽明交大水所在陽交校慶系列活動