Ngrok中文文檔

1.入門

將本地Web服務(wù)器暴露給互聯(lián)網(wǎng)

ngrok允許您將本地計(jì)算機(jī)上運(yùn)行的Web服務(wù)器公開到Internet。 告訴ngrok你的網(wǎng)絡(luò)服務(wù)器正在偵聽哪個端口哲戚。
如果您不知道Web服務(wù)器正在偵聽哪個端口爹耗,那么它可能是端口80耙考,默認(rèn)為HTTP谜喊。
示例:將本地計(jì)算機(jī)的端口80上的Web服務(wù)器暴露給Internet

  ngrok http 80

當(dāng)您啟動ngrok時,它將在您的終端中顯示一個UI琳骡,其中包含您的隧道的公共URL以及有關(guān)通過隧道進(jìn)行連接的其他狀態(tài)和度量信息锅论。

ngrok控制臺UI

  ngrok by @inconshreveable 
  Tunnel Status           online 
  Version                 2.0/2.0 
  Web Interface           http://127.0.0.1:4040 
  Forwarding              http://92832de0.ngrok.io -> localhost:80 
  Forwarding              https://92832de0.ngrok.io -> localhost:80 
  Connnections            ttl      opn      rt1      rt5      p50      p90
                          0        0        0.00     0.00     0.00     0.00
檢查您的流量

ngrok提供了一個實(shí)時的網(wǎng)絡(luò)用戶界面,您可以在其中內(nèi)省您通過隧道運(yùn)行的所有HTTP流量楣号。 啟動ngrok之后最易,只需在Web瀏覽器中打開 http:// localhost:4040 即可查看請求詳細(xì)信息。
嘗試向您的公開網(wǎng)址發(fā)出請求炫狱。 之后藻懒,回顧檢查界面。 您將看到請求和響應(yīng)的所有詳細(xì)信息视译,包括時間嬉荆,持續(xù)時間,頭酷含,查詢參數(shù)和請求負(fù)載以及電線上的原始字節(jié)鄙早。

詳細(xì)反思HTTP請求和響應(yīng)

請求響應(yīng)
重播請求

開發(fā)由外部API發(fā)布的Webhook可能會通過要求您進(jìn)行一些工作(如撥打電話)來觸發(fā)掛接請求,從而減慢開發(fā)周期椅亚。 ngrok允許您通過單擊重播任何請求限番,大大加快了迭代周期。 點(diǎn)擊Web檢查用戶界面上任何請求右上角的“ 重播”按鈕重播呀舔。

一次點(diǎn)擊即可重播任何針對您的隧道式網(wǎng)絡(luò)服務(wù)器的請求

重播請求
請求身體驗(yàn)證

ngrok特別支持在網(wǎng)絡(luò)上使用的最常見的數(shù)據(jù)交換格式弥虐。 請求或響應(yīng)主體中的任何XML或JSON數(shù)據(jù)將自動為您打印并檢查語法錯誤。

突出顯示JSON語法錯誤的位置

請求身份驗(yàn)證
安裝你的Authtoken

在進(jìn)一步部分描述的ngrok.com服務(wù)的許多高級功能要求您注冊一個帳戶 媚赖。 注冊后霜瘪,您需要使用信息顯示板上顯示的authtoken配置ngrok。 這將授予您訪問僅帳戶功能的權(quán)限惧磺。 ngrok有一個簡單的'authtoken'命令颖对,使這很容易。 在引擎蓋下豺妓,所有authtoken命令都是在ngrok配置文件中添加(或修改) authtoken屬性惜互。

安裝你的authtoken

   ngrok authtoken <YOUR_AUTHTOKEN> 

2.HTTP隧道

自定義子域名

ngrok為您打開的HTTP隧道分配隨機(jī)的十六進(jìn)制名稱。 這是一次性的個人用途琳拭。 但是训堆,如果您在hackathon中顯示該URL或與第三方Webhook集成,則如果隧道名稱更改或難以閱讀白嘁,則可能會令人沮喪坑鱼。 您可以使用-subdomain開關(guān)為隧道網(wǎng)址指定自定義子域。

示例:密碼保護(hù)您的隧道

   ngrok http -auth="username:password" 8080 
自定義域上的隧道(白標(biāo)網(wǎng)址)

您的隧道不會顯示為ngrok.io的子域,ngrok.io可以在您的域上運(yùn)行ngrok隧道鲁沥。 要在dev.example.com運(yùn)行隧道呼股,請按照下列步驟操作:

  • ngrok.com信息中心的“保留”選項(xiàng)卡上輸入dev.example.com作為保留域。 這樣可以確保沒有其他人可以使用自己的隧道來劫持您的域名画恰。
  • 在信息中心上彭谁,點(diǎn)擊“CNAME”圖標(biāo)復(fù)制您的CNAME目標(biāo)。
  • dev.example.com創(chuàng)建一個DNS CNAME記錄到您的CNAME目標(biāo)允扇。 在這個例子中缠局,我們將CNAME記錄指向2w9c34maz.cname.ngrok.io
  • 使用-hostname開關(guān)調(diào)用ngrok,并將自定義域的名稱指定為參數(shù)考润。

示例:在自定義域上運(yùn)行隧道

  ngrok http -hostname=dev.example.com 8000 

注意:通過HTTPS訪問自定義域隧道仍然可以工作狭园,但證書不匹配。 如果您有TLS證書/密鑰對糊治,請嘗試使用TLS隧道唱矛。

禁用檢查

ngrok記錄您的隧道上的每個HTTP請求和響應(yīng)以進(jìn)行檢查和重播。 雖然這對開發(fā)非常有用井辜,但是當(dāng)您在生產(chǎn)服務(wù)上運(yùn)行ngrok時绎谦,您可能希望禁用它以實(shí)現(xiàn)安全性和性能。 使用-inspect開關(guān)來禁用您的隧道檢查粥脚。

示例:沒有檢查的http隧道

重寫主機(jī)頭

轉(zhuǎn)發(fā)到本地端口時燥滑,ngrok根本不修改隧道HTTP請求,它們在接收到字節(jié)時被復(fù)制到服務(wù)器字節(jié)阿逃。 一些應(yīng)用服務(wù)器(如WAMP,MAMP和pow)使用Host頭來確定要顯示的開發(fā)站點(diǎn)赃蛛。 因此恃锉,ngrok可以使用修改的主機(jī)頭重寫您的請求。 使用-host-header開關(guān)重寫傳入的HTTP請求呕臂。

如果指定了rewrite 破托,則Host頭將被重寫,以匹配轉(zhuǎn)發(fā)地址的主機(jī)名部分歧蒋。 任何其他值將導(dǎo)致將Host頭重寫為該值土砂。

將主機(jī)頭重寫為“site.dev”

   ngrok http -host-header=rewrite site.dev:80

將主機(jī)頭重寫為'example.com'

   ngrok http -host-header=example.com 80 
僅隧道HTTP或HTTPS

HTTPS隧道使用ngrok.com證書終止ngrok.com服務(wù)器上的所有TLS(SSL)流量。 對于生產(chǎn)級服務(wù)谜洽,您需要使用自己的TLS密鑰和證書對您的隧道流量進(jìn)行加密萝映。 使用TLS隧道,ngrok非常方便阐虚。

將TLS流量轉(zhuǎn)發(fā)到端口443上的本地HTTPS服務(wù)器

   ngrok tls -subdomain=encrypted 443 

隧道運(yùn)行后序臂,嘗試使用卷曲進(jìn)行訪問。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末实束,一起剝皮案震驚了整個濱河市奥秆,隨后出現(xiàn)的幾起案子逊彭,更是在濱河造成了極大的恐慌,老刑警劉巖构订,帶你破解...
    沈念sama閱讀 218,204評論 6 506
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件侮叮,死亡現(xiàn)場離奇詭異,居然都是意外死亡悼瘾,警方通過查閱死者的電腦和手機(jī)囊榜,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,091評論 3 395
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來分尸,“玉大人锦聊,你說我怎么就攤上這事÷嵘埽” “怎么了孔庭?”我有些...
    開封第一講書人閱讀 164,548評論 0 354
  • 文/不壞的土叔 我叫張陵,是天一觀的道長材蛛。 經(jīng)常有香客問我圆到,道長,這世上最難降的妖魔是什么卑吭? 我笑而不...
    開封第一講書人閱讀 58,657評論 1 293
  • 正文 為了忘掉前任芽淡,我火速辦了婚禮,結(jié)果婚禮上豆赏,老公的妹妹穿的比我還像新娘挣菲。我一直安慰自己,他們只是感情好掷邦,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,689評論 6 392
  • 文/花漫 我一把揭開白布白胀。 她就那樣靜靜地躺著,像睡著了一般抚岗。 火紅的嫁衣襯著肌膚如雪或杠。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,554評論 1 305
  • 那天宣蔚,我揣著相機(jī)與錄音向抢,去河邊找鬼。 笑死胚委,一個胖子當(dāng)著我的面吹牛挟鸠,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播篷扩,決...
    沈念sama閱讀 40,302評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼兄猩,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起枢冤,我...
    開封第一講書人閱讀 39,216評論 0 276
  • 序言:老撾萬榮一對情侶失蹤鸠姨,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后淹真,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體讶迁,經(jīng)...
    沈念sama閱讀 45,661評論 1 314
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,851評論 3 336
  • 正文 我和宋清朗相戀三年核蘸,在試婚紗的時候發(fā)現(xiàn)自己被綠了巍糯。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 39,977評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡客扎,死狀恐怖祟峦,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情徙鱼,我是刑警寧澤宅楞,帶...
    沈念sama閱讀 35,697評論 5 347
  • 正文 年R本政府宣布,位于F島的核電站袱吆,受9級特大地震影響厌衙,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜绞绒,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,306評論 3 330
  • 文/蒙蒙 一婶希、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧蓬衡,春花似錦喻杈、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,898評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至家肯,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間盟猖,已是汗流浹背讨衣。 一陣腳步聲響...
    開封第一講書人閱讀 33,019評論 1 270
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留式镐,地道東北人反镇。 一個月前我還...
    沈念sama閱讀 48,138評論 3 370
  • 正文 我出身青樓,卻偏偏與公主長得像娘汞,于是被迫代替她去往敵國和親歹茶。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,927評論 2 355

推薦閱讀更多精彩內(nèi)容