架設 Stirling PDF

想使用現成的可到 Stirling PDF 官網，或社群免費自架版。

在得知 Stirling PDF 之後，立刻去找好朋友 ChatGPT 聊聊，得知 2 種安裝方式：(1) 直接安裝在系統上；(2) 透過 Docker 安裝。小蛙要安裝的這台主機正好有 Docker，於是使用了這個較簡單的方法。

1. 拉取 docker image

docker pull stirlingtools/stirling-pdf:latest

2. 建立所需的資料夾

mkdir -p ~/StirlingPDF/{trainingData,extraConfigs,customFiles,logs,pipeline}

3. 拉取 docker image

docker run -d \
  --name stirling-pdf \
  -p 8080:8080 \
  -v ~/StirlingPDF/trainingData:/usr/share/tessdata \
  -v ~/StirlingPDF/extraConfigs:/configs \
  -v ~/StirlingPDF/customFiles:/customFiles/ \
  -v ~/StirlingPDF/logs:/logs/ \
  -v ~/StirlingPDF/pipeline:/pipeline/ \
  -e DOCKER_ENABLE_SECURITY=false \
  -e LANGS=en_US \
  stirlingtools/stirling-pdf:latest

4. 測試

輸入 http://localhost/ 就可以看到畫面了

設定 Nginx 反向代理

小蛙的主機使用 nginx 反向代理，還需要在 nginx 設定檔中加入以下設定

server {
    listen 443 ssl;
    server_name __your_domain__;  # 替換成自己的域名

    client_max_body_size 300M;    # 上傳 PDF 的大小，可調整

    ssl_certificate         /etc/nginx/ssl/__your_cert__;
    ssl_certificate_key     /etc/nginx/ssl/__your_key__;

    location / {
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection "upgrade";
            proxy_pass http://localhost:8080;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
    }
}

重啟 nginx 後，就能使用上面設定的網址來訪問 Stirling PDF 囉 ~ 以後處理 PDF 簡單輕鬆又安全！幾乎所有常見的功能都有了，大推。如果不放心這個工具放在網路上會被濫用，還可以透過 使用 Cloudflare 使用 Zero Trust 原則保護特定網址 多做一層防護喔！

這篇文章 Stirling PDF: 自行架設全方位免費 PDF 線上工具 最早出現於 記下來。

PHPMailer + Gmail OAuth 發信大概有幾個步驟：

1. 安裝必要套件：使用 composer 在網站上安裝 phpmailer/phpmailer 及 league/oauth2-google 套件。
2. 建立 OAuth 2.0 用戶端 ID 憑證：到 Goolge Cloud 建立一個專案，並開啟 Gmail API 與建立一個 OAuth 2.0 用戶端 ID 憑證。
3. 取得 Refresh Token：設定 get_oauth_token.php 通過 OAuth 驗證，取得 Refresh Token。
4. 使用 PHPMailer 寄信：使用 PHPMailer 搭配前幾步得到的資訊寄送郵件。

安裝必要套件

需使用 composer 安裝必要套件，沒有 composer 的話可參考這邊。

composer require phpmailer/phpmailer
composer require league/oauth2-google

建立 OAuth 2.0 用戶端 ID 憑證

啟用 Gmail API

進入到 Google Cloud，點擊左上方專案下拉選單 -> 新增專案 -> 輸入專案名稱，只要自己能辨識的即可，下面若有機構、位置，也都必須填寫上去

專案建立完成後進入該專案，左側選擇「已啟用的 API 和服務」，點擊「啟用 API 和服務」

找到並啟用 Gmail API

建立 OAuth 用戶端 ID 憑證

成功啟用 Gmail API 後，左側進入「憑證」選單 -> 點擊「建立憑證」 -> OAuth 用戶端 ID

第一次建立需要先設定同意畫面，點擊「設定同意畫面」

我們的目的是完成至少一次 OAuth 驗證取得 Refresh Token，這邊選「內部」就可以了

應用程式名稱、使用者支援電子郵件及開發人員聯絡資訊為必填項目，其餘部份視情況填寫，填寫完成後點擊「儲存並繼續」。

第二步範圍部份直接留空，點擊「儲存並繼續」

OAuth 同意畫面建立完成

再回到「憑證」->「建立憑證」->「OAuth 用戶端 ID」

應用程式類型選擇「網頁應用程式」，名稱為必填，可以跟小蛙一樣輸入 PHPMailer，只要能辨識即可。「已授權的重新導向 URI」填入網站下 phpmailer 套件下的 get_oauth_token.php 路徑 (也可以把它拉出來到外層比較好處理的地方)，小蛙這邊的例子是

https://xx.xxx/vendor/phpmailer/phpmailer/get_oauth_token.php

建立完成後會得到用戶端編號及用戶端密鑰，先存起來等一下馬上會用到。

取得 Refresh Token

找到 PHPMailer 下的 get_oauth_token.php (預設應該會在網頁目錄下的 vender/phpmailer/phpmailer/)，PHPMailer 原始附帶的檔案會一直卡在 Provider missing 或 Invalid state，沒辦法正確取得 Refresh Token，因此小蛙對 get_oauth_token.php 做了一些修改，確保可以拿到 token。

<?php
/**
 * PHPMailer - PHP email creation and transport class.
 * PHP Version 5.5
 * @package PHPMailer
 * @see https://github.com/PHPMailer/PHPMailer/ The PHPMailer GitHub project
 * @author Marcus Bointon (Synchro/coolbru) <phpmailer@synchromedia.co.uk>
 * @author Jim Jagielski (jimjag) <jimjag@gmail.com>
 * @author Andy Prevost (codeworxtech) <codeworxtech@users.sourceforge.net>
 * @author Brent R. Matzelle (original founder)
 * @copyright 2012 - 2020 Marcus Bointon
 * @copyright 2010 - 2012 Jim Jagielski
 * @copyright 2004 - 2009 Andy Prevost
 * @license https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html GNU Lesser General Public License
 * @note This program is distributed in the hope that it will be useful - WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.
 */

/**
 * Get an OAuth2 token from an OAuth2 provider.
 * * Install this script on your server so that it's accessible
 * as [https/http]://<yourdomain>/<folder>/get_oauth_token.php
 * e.g.: http://localhost/phpmailer/get_oauth_token.php
 * * Ensure dependencies are installed with 'composer install'
 * * Set up an app in your Google/Yahoo/Microsoft account
 * * Set the script address as the app's redirect URL
 * If no refresh token is obtained when running this file,
 * revoke access to your app and run the script again.
 */

namespace PHPMailer\PHPMailer;

// 用來看錯誤訊息以及刪除 opcache
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);
@opcache_reset();
	
/**
 * Aliases for League Provider Classes
 * Make sure you have added these to your composer.json and run `composer install`
 * Plenty to choose from here:
 * @see https://oauth2-client.thephpleague.com/providers/thirdparty/
 */
//@see https://github.com/thephpleague/oauth2-google
use League\OAuth2\Client\Provider\Google;

// 根據自己的 vendor 路徑進行調整
require '../../autoload.php';

session_start();

// 改成剛剛在 Google Cloud 上設定的值
$providerName = 'Google';
// 用戶端編號
$clientId = 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.apps.googleusercontent.com';
// 用戶端密碼
$clientSecret = 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
// 已授權的重新導向 URI
$redirectUri = 'https://xxx.xxxx.xxx/get_oauth_token.php';

$_SESSION['provider'] = $providerName;
$_SESSION['clientId'] = $clientId;
$_SESSION['clientSecret'] = $clientSecret;

$params = [
    'clientId' => $clientId,
    'clientSecret' => $clientSecret,
    'redirectUri' => $redirectUri,
    'accessType' => 'offline'
];

$options = [];
$provider = null;

switch ($providerName) {
    case 'Google':
        $provider = new Google($params);
        $options = [
            'scope' => [
                'https://mail.google.com/'
            ]
        ];
        break;
}

if (null === $provider) {
    exit('Provider missing');
}

if (!isset($_GET['code'])) {
    //If we don't have an authorization code then get one
    $authUrl = $provider->getAuthorizationUrl($options);
    $_SESSION['oauth2state'] = $provider->getState();
    header('Location: ' . $authUrl);
    exit;
    //Check given state against previously stored one to mitigate CSRF attack
	// 這段不註解掉的話，會一直卡在 Invalid state，沒辦法拿到正確的 token
/*} elseif (empty($_GET['state']) || ($_GET['state'] !== $_SESSION['oauth2state'])) {
	error_log("3333");
	error_log("state 3333 " . $_SESSION['oauth2state']);
    //unset($_SESSION['oauth2state']);
    //unset($_SESSION['provider']);
    exit('Invalid state');*/
} else {
    //unset($_SESSION['provider']);
    //Try to get an access token (using the authorization code grant)
    $token = $provider->getAccessToken(
        'authorization_code',
        [
            'code' => $_GET['code']
        ]
    );
    //Use this to interact with an API on the users behalf
    //Use this to get a new access token if the old one expires
    echo 'Refresh Token: ', htmlspecialchars($token->getRefreshToken());
}

將內容貼上後，開啟瀏覽器連到該網址 (就是已授權的重新導向 URI) 開始進入 OAuth 登入流程，選擇要登入的帳號

確認登入

信任應用程式

最後會印出 Refresh Token: xxxxxxxxxx，這個 token 一定要存好，少了這個 PHPMailer 就沒辦法透過 OAuth 驗證寄信喔，原本以為 get_oauth_token.php 每次執行應該 “有機會” 去換一個可使用的 Token 回來，不過再執行一次會發現 Refresh Token: 變成空白。

到這邊就成功取得可以使用的 Token 了，回到 PHPMailer 寄信程式吧！

使用 PHPMailer 寄信

複製下面的檔案，視自身情況修改幾個地方：

1. require(‘./vendor/autoload.php’);：將位置指向正確的路徑。
2. $client_id：前面步驟取得的用戶端編號。
3. $client_secret：前面步驟取得的用戶端密碼。
4. $refresh_token：前面步驟取得的 Token。
5. $email：前面步驟通過 OAuth 的信箱。
6. 信件相關之寄件人、收件人、主旨、內容 … 等。

<?php

// 用來看錯誤訊息以及刪除 opcache
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);
@opcache_reset();

// 根據自己的路徑修改 composer 的載入位置
require('./vendor/autoload.php');

use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\SMTP;
use PHPMailer\PHPMailer\Exception;
use PHPMailer\PHPMailer\OAuth;
use League\OAuth2\Client\Provider\Google;

// 用戶端編號
$client_id 	= 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.apps.googleusercontent.com';
// 用戶端密碼
$client_secret 	= 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';
// 從前一個步驟取得的 Token
$refresh_token  = '1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxg';
// OAuth 的信箱
$email		= 'xxxxxxx@xxxxxxx';

$mail = new PHPMailer(true);

$provider = new Google(
	[
		'clientId' => $client_id,
		'clientSecret' => $client_secret,
	]
);

$mail->setOAuth(
	new OAuth(
		[
			'provider'     => $provider,
			'clientId'     => $client_id,
			'clientSecret' => $client_secret,
			'refreshToken' => $refresh_token,
			'userName'     => $email,
		]
	)
);

$mail->isSMTP();

$mail->SMTPDebug 	= 3;				// 如果需要顯示debug內容,測完確定沒問題請改成 0
$mail->SMTPAuth 	= true; 
$mail->SMTPSecure 	= 'tls';
$mail->AuthType 	= 'XOAUTH2';
$mail->Host 		= "smtp.gmail.com";
$mail->Port 		= 587;
$mail->CharSet 		= "utf-8";

$mail->setFrom('寄件人信箱', '寄件人名稱');    // 寄件人
$mail->addAddress('收件人信箱', '收件人名稱'); // 收件人
$mail->isHTML(true);                         // 寄送 HTML 格式郵件

$mail->Subject = "郵件主旨";                  // 主旨
$mail->Body    = "<Strong>測試</Strong>";     // 信件內容
$mail->AltBody = "測試";                      // 無法顯示 HTML 時的內容

$mail->send();

?>

一切就緒後連到該寄信的 PHP 頁面，就可以成功把信寄出囉！

延伸閱讀：Google 試算表批量發送 Email (免費版每日 50 封)

這篇文章 PHPMailer + Gmail OAuth2 寄信 最早出現於 記下來。

IFTTT 在工作常被我們用來當作一個傳遞訊息的媒介，例如：當某個網路服務發生錯誤時，透過 LINE 通知，隨著 IFTTT 將該功能進行收費後，程式也隨之停擺；加上為了追蹤 YouTube 訂閱數，閒暇時寫了一支在訂閱數發生變化時發送 LINE 通知的工具也隨著休眠，在還沒有購買 IFTTT pro 前，先來介紹這套可以免費透過 webhook 發送 LINE 通知的好用工具－Make。

IFTTT 替代方案 – Make 收費與註冊

免費版本的限制是每個月只能接受 1,000 次請求，以小蛙的狀況 1,000 個綽綽有餘，價位看起來比 IFTTT 還要貴，每個月從 9 元 ~ 29 元不等

(1) 首先連到 make 首頁，點擊右上方 Get started free 進行註冊

(2) 輸入姓名，Email 及密碼，Hosting Region 是指帳號資料放置的位置，可以選擇 EU 歐洲或是 US 美國，Country 選擇 Taiwan 後點擊 Sign up for FREE

(3) Make 會陸續問幾個問題，根據自己的狀況選取，像是你的角色、你使用自動化工具 Make 的目的、你對自動化工具的經驗、你怎麼知道 Make 的、組織規模人數 … 等

(4) 註冊完成後，收到一封電子郵件確認函，點擊 Verify email 進行驗證

建立及設定 Make Scenario

(5) 第一次登入進到首頁後，畫面右上方可以看到 Create a new scenario，建立一個新的腳本

建立 Webhook 模組

(6) 點擊畫面上大大的 + 按鈕，旁邊開啟一個視窗是要使用的工具，在下方搜尋 webhook 後點擊 Webhooks，讓我們的 Make 可以接受來自網址的觸發方式 (trigger)

(7) TRIGGERS 選擇 Custom webhook

(8) 點擊 Create a webhook 開始建立自訂的 webhook

(9) 輸入 Webhook 的名字，如果你怕自己的 webhook 被盜用，可以設定特定 IP，讓 webhook 只接受特定 IP 發送的請求

驗證並抓取 Webhook 參數

(10) 儲存後可以看見一個 webhook 網址，點擊 Copy address to clipboard，將複製出來的網址貼在 Chrome 瀏覽器上，瀏覽器會顯示「Accepted」，回到 Make 畫面會變成 Successfuly determined (下圖右) 就完成 webhook 設定了，這邊可以先將等等要設定的參數以 ? 的方式加在最後面，例如：https://hook.us1.make.com/xj4.,…412.4.sf5?status=hello，藍色部分是 webhook 網址，紅色部分 status 就是小蛙等一下要傳遞的參數。

建立 LINE 模組

(11) 點擊 Add another module 新增一個 LINE 通知模組

(12) 按下新跑出空白模組上大大的 + 後 -> Add another module -> 搜尋並點擊 LINE 模組

(13) 選擇 NOTIFY API 下的 Send a Notification

(14) 接著跳出建立連線視窗，第一次使用 LINE 模組必須要先建立連線，自行輸入 Connection name

(15) 登入 LINE 設定與 LINE 連動，下圖右可選擇要使用哪一種通知視窗，可以傳送一對一通知、特定群組或特定聯絡人

完成連動會收到一封 LINE 通知

設定 LINE 模組發送訊息

(16) 設定 LINE 要發送的訊息，由於上面我們透過 webhook 連結後面加上 ?status=hello，這邊 Message 點下去的時候，會自動抓取 status 這個參數，之後如果要變更參數的話，加入新參數，例如：?status=hello&name=hans (第二個之後的參數要用 & 連接)，再執行一次前面 (10) webhook 連結的步驟，這邊就會可以抓到 status 跟 name 兩個參數了

完成設定及測試

(17) 完成後要按儲存才能把這次的 scenario 存下來，將左下方 SCHEDULING 切換成 ON，這個腳本就會開始接收請求囉！

(18) Message 裡面很多變數可以使用，經過小蛙調整，如果訂閱數有變動，會發送 LINE 訊息通知，你也可以根據 Message 內的說明調整發送的訊息

小蛙使用 PHP 來呼叫，如果你有其他可以觸發發送 http request 的工具也同樣可以使用，PHP 程式碼部分如下

$url  = 'https://hook.us1.make.com/d................t?status=要傳的參數';
$curl = curl_init($url);
curl_setopt($curl, CURLOPT_HEADER, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_TIMEOUT, 15);
$result = curl_exec($curl);
curl_close($curl);

IFTTT 收費後，如果每個月的 webhook 用量小於 1,000 的話，可以考慮這款免費、可以用來替代 IFTTT 的自動化工具 Make 喔！

這篇文章 IFTTT 收費後的免費替代方案 Make 最早出現於 記下來。

什麼是 Hyper-V 虛擬機器？

Hyper-V是Microsoft Windows作業系統中的一項虛擬化技術，它允許在單一主機上運行多個虛擬機器（VMs）。Hyper-V虛擬機是在主機操作系統之上建立的獨立環境，每個虛擬機器都具有自己的作業系統、應用程式和資源。

Hyper-V提供了虛擬化平台，可在Windows Server和某些Windows工作站版中使用。它是一個基於類型-1（bare-metal）架構的虛擬化解決方案，這意味著它直接在硬體上運行，而不需要額外的操作系統。這使得虛擬機器能夠更高效地運行，並提供接近原生性能的效能。

ChatGPT 產生

嗯嗯，Hyper-V 就是這麼回事，另外還有 VMware vSphere、Oracle VM VirtualBox … 等類似的工具提供相關虛擬機器 (Virtual Machine) 的功能。

Hyper-V 虛擬機器無法開機

小蛙這次遇到的問題是虛擬機器 (Virtual Machine，以下簡稱 VM) 儲存空間爆了，造成 Hyper-V 沒辦法正常重啟 VM，一開始不知道怎麼辦胡亂設定了一通，結果讓 VM 完全整個無法啟動 … 原本放在 VM 裡面的資料也拿不出來 Orz …

後來想到以前 Windows 掛掉沒辦法開機的時候，可以使用類似 NoName XPE 的工具，把作業系統跑在光碟上或是隨身碟上，並且包含了許多修復工具，透過這種方式來修復原本出問題的作業系統，Linux 早期也有聽過 Live CD，如果以 Live CD 使用光碟機開機，就能將不能開機的 VM 空間清出來，或是把資料 copy 出來了。

Live CD 解決方案

以小蛙的狀況為例，使用的作業系統是 Ubuntu 20.04 Desktop 版本，首先必須要先到 Ubuntu 官網下載 ISO 映像檔，接著進入 Hyper-V，在無法開機的 VM 點擊滑鼠右鍵 -> 設定

左側切換到 SCSI 控制器，選擇 DVD 光碟機後，點擊右下角新增

選擇剛剛下載的映象檔後儲存設定

接著到左側韌體，將 DVD 光碟機移動到最上面，儲存後啟動 VM

若以上設定成功，開機後會見到以下畫面，選擇中文(繁體) -> 試用 Ubuntu

等待一下下就進到 Ubuntu 桌面囉

點擊左下角查看所有程式，找到 Disks 磁碟管理工具

左側選取 VM 使用的硬碟，右邊選取正確的磁區後，點擊像播放鍵的按鈕將硬碟掛載起來

掛載完成會看到播放鍵變成停止鍵了，同時最下面可以看到硬碟掛載的路徑

開啟 Terminal，輸入 sudo su 切換成 root 使用者，再進到掛載的目錄 /media/ubuntu/desktop-rootfs/ 就可以把 VM 裡的檔案複製出來或是清裡不必要的檔案挪出空間囉！

其他技術相關文章。

這篇文章 1 招解決 Hyper-V 虛擬機器無法開機 最早出現於 記下來。

想說直接再安裝一次 Chrome 搞不好就好了，再次上網確認重新安裝一次會不會有問題，有不少文章介紹可以直接重新安裝，不用把原本的 Chrome 移除，原本的設定之類的也不會遺失，遇到此問題的朋友不用再去試其他方法了，再安裝一次 Chrome 讓安裝檔自己修復這個問題，重新安裝完之後再次開啟 Chrome，一切就正常囉！

Chrome 下載連結：https://www.google.com/intl/zh-TW/chrome/

最後分享一下 好用的 Chrome 插件推薦。

這篇文章 1 招解決「因為應用程式的並列設定不正確，所以無法啟動 Chrome 問題修正」 最早出現於 記下來。

若想使用 Word + Excel + Outlook 發信 (無附加檔案功能) 可參考 Word 合併列印使用 Outlook 發送郵件，使用現成的擴充功能 > 外掛程式 (較簡單但每日限 50 封) 發送信件及附加檔案可參考 Google 試算表批量發送 Email (免費版每日 50 封) – 使用 Yet Another Mail Merge: Mail Merger for Gmail (YAMM)

Google 為避免濫用，針對使用 Apps Script 發信設定了限額，一般免費版的 Google 帳號每日發送限額是 100 封，如果是 Google Workspace 帳戶的話，每日發送限額提升到 1,500 封喔！

什麼是 Apps Script

Apps Script 是一種用於建立和管理 Google Workspace 應用程式（原名 Google Apps）的編程平台。它基於 JavaScript 語言，可以讓您自定義 Google Workspace 應用程式的功能，或者建立新的應用程式。

Apps Script 可以用於各種 Google Workspace 應用程式，包括 Gmail、Google 表單、Google 文檔、Google 工作表和 Google 地圖等。例如，您可以使用 Apps Script 自動化電子郵件傳送流程，或者在 Google 表單中添加自定義功能。

ChatGPT 產生 (無法保證資訊正確性)

感謝 ChatGPT 大師，由此可知透過 Google 試算表也可以使用 Apps Script 來進行自動化電子郵件傳送寄送。

Mail Merge for Batch Email

今天要使用的 Mail Merge for Batch Email 是一位香港老師所開發，並在網路上分享 (超佛)，將 Apps Script 處理發送電子郵件的相關功能寫在 Google 試算中，只要透過「建立副本」就可以將整個功能複製回自己的 Google 雲端硬碟，超級方便。

小蛙寫這篇文章的時候版本來到 8.02，不過實際操作的時候 8.02 卻不斷出現問題，因此這篇會以前一版 7.00 為主。

建立 Google 試算表副本

連到 這裡 開啟 Google 試算表，小蛙使用的是 v7.00 (原本使用 v8.02 但一直失敗)

進入後會看到以下畫面，點擊「建立副本」就把這個發送大量郵件的強大功能複製到自己的雲端硬碟了，接下去看後續設定。

建立 Google 試算表副本

第一次開啟時，頂端工具列最右邊 (說明旁邊) 應該要出現 Mail Merge for Batch Email，如果畫面跟下圖一樣的話，就典籍「擴充功能」->「Apps Script」

直接點擊「執行」，由於 Apps Script 使用到特殊權限，基於安全性的理由，需要由使用者接受這些權限之後才可以繼續下去

出現執行完畢，沒有出現任何錯誤後，回到 Google 試算表可以看到多出 Mail Merge for Batch Email 選單

設定附件資料夾 ID

如果要使用到附加檔案的話，有兩個方法，先介紹第一個：透過 Mail Merge for Batch Email -> Pick Folder for Attachment 選取

小蛙把要夾帶的檔案都存放在 Goolge 雲端硬碟 > 證書 資料夾中，從下拉選單中選擇「證書」資料夾後，點擊 Pick This Folder

選擇完成後會發現 Settings 頁籤內的 Folder ID 欄位自動填入值

第二個方法不透過該選單，而是直接開啟存放附加檔案的資料夾後，從網址列複製 (/folders/複製這邊)，接著貼進同上圖的位置

設定 DataSheet 收件人資料

繼續使用之前的範例，小蛙希望寄送的郵件內容是

黃小蛙 先生 您好：

感謝您參加 Google 研習，附件為您的證書。

記下來 敬上

首先切換到 DataSheet 頁籤，黃底欄位的表頭（To Send, Done, Email Address, Template, Attachment List, SubFolder）不可以修改，也不可以把欄位刪除，其他白底的欄位才是自己可以刪除調整的，小蛙把所有原本有的欄位都刪掉，只留下自己要的 Name、Title 跟 Event。Attachment List 填入小蛙要附加的檔案 s0001.png 及 s0002.png

欄位說明如下：

• To Send：是否要發送郵件。如果不要的話改成 no。
• Done：發送完成時顯示發送狀態。
• Email Address：收件者 Email。
• Template：要使用哪個範本發送。
• Attachment List：要附加的檔案。
• SubFolder：附加檔的子目錄，若上述 Folder ID 下還有子目錄的話，可以輸入在這邊。
• Name：姓名，自訂變數。
• Title：頭銜，自訂變數。
• Event：活動名稱，自訂變數。

設定 Settings 寄件資料

• Cc：電子郵件副本，若有多個可用 , 分隔。
• Bcc：電子郵件密件副本，若有多個可用 , 分隔。
• Folder ID：附加郵件在雲端硬碟的 id，前面的步驟已設定。
• Send as：寄件者名稱。
• Replay to：收件者回覆的信箱。
• No replay：是否允許回覆。

依自己的狀況填寫，CC 及 BCC 若沒有的話可以留空白，其他的請填寫正確

設定 Template1 郵件範本

這部份原始範例可能會比較混亂一點，不過可以跟小蛙一樣先把內容刪除，再自己一個一個填入，我們先不管粗體、斜體、底線、清單 … 等 Markdown 的語法，把 Subject 跟 Body 先填好，例如：小蛙的主題是「感謝您參加 Google 研習」，因為上面小蛙把參加的活動設定為變數 Event，因此把「感謝您參加 Google 研習」改成「感謝您參加 ${“Event”}」，以此類推，其他部份如「黃小蛙 先生 您好：」就會變成「${“Name”} ${“Title”} 您好」。

再來 Markdown 呈現的部份則有

• 斜體：用單個 * 包起來，例如：*這裡會變成斜體*
• 粗體：用兩個 * 包起來，例如：**這裡會變成斜體**
• 底線：用兩個 _ 包起來，例如：__這裡會變成斜體__
• 條列：用數字及 . 條列，例如：1. xxxx 2. oooo
• 項目：用 * – + 符號條列，例如：* 項目a * 項目b
• 換行：在行尾加入兩個空白

更多 Markdown 語法可參考 Markdown Cheatsheet

Google 試算表寄送大量郵件

都設定完成後，點擊 Mail Merge for Batch Email -> Send Emails Now!，點擊「是」開始送信，送信期間請保持視窗開啟，不可以關閉。

發送成功會顯示 Done

過一下就可以收到信囉！有各自的內容及不同的附件

完成送信後還會寄一份詳細資料到您的信箱，包含送出的內容以及當日還能寄送多少封信

打完收工～！

這篇文章 Google 試算表寄送大量郵件，每天免費 100 封 最早出現於 記下來。

對於介紹性的內容小蛙真的很懶惰去查，因此使用了最近非常紅的 ChatGPT 來幫忙產生相關說明

什麼是 Outlook？

Microsoft Outlook 是一款電子郵件客戶端軟體，除了可以收發電子郵件之外，還具有日曆、聯絡人管理、任務清單、記事本等功能。它是微軟 Office 文書處理軟體套件的一部分，也可以單獨使用。Outlook 支援多種電子郵件服務，包括 Exchange、POP3 和 IMAP，可以讓使用者從一個地方管理所有的電子郵件帳戶。Outlook 还提供了許多安全和隱私保護功能，例如密碼保護、數位簽名和加密等。

ChatGPT 產生 (無法保證資訊正確性)

Good～感謝 ChatGPT

使用 Outlook 收發 Gmail

第一次啟動 Outlook 會要求新增帳戶，這邊輸入要使用的 Gmail 帳號，點擊連線

偵測到是 Gmail 後，開啟視窗讓使用者登入

如果有開啟二階段登入驗證的話，會再出現要求做驗證 (下圖左)，接著列出所有使用 Outlook 收發信需要使用到的權限 (下圖右)

拉到最下面點選接受就完成設定了，過程非常簡單

還會貼心的試寄一封郵件

打完收工！

你可能感興趣的內容：
Google 試算表寄送大量郵件，每天免費 100 封
Google 試算表批量發送 Email (免費版每日 50 封)
Word 合併列印使用 Outlook 發送郵件

這篇文章 Microsoft Outlook 收發 Gmail 設定教學 最早出現於 記下來。

小蛙現在使用的手機是 iPhone，不過因為常常要協助處理 Android 的狀況，多少還是了解一些，不過這次要幫忙重置手機卻發現沒辦法進入工程模式，上網查了一下發現 Sony Xperia 可以透過 Sony 官方的 Xperia Companion 這套軟體重置。

放一篇蠻詳細的重置法給大家參考 4招快速解決手機密碼忘記，手機開機密碼忘記難題，無需密碼！，小蛙成功重置後才發現這篇文章，原來忘記螢幕鎖密碼還可以直接透過 Google 帳號處理，如果你還記得 Google 帳號密碼且還可以連網路的話，可以參考看看喔！另外兩篇是 Sony 官方的教學文件一併附在這邊 我無法解鎖螢幕 (Android 5.0 或更高版本)、我無法解鎖畫面 (Android 4.4 或較舊版本)。

安裝 Xperia Companion

連到 Sony 官網下載 Xperia Companion

下載完畢後點擊兩下進行安裝。

使用 Xperia Companion 重置手機

安裝完成後開啟 Xperia Companion 可以看到以下畫面，點擊「軟體修復」進入選單

要直接重置手機的話，勾選「我的裝置無法偵測或重新啟動，或為SmartWatch3」，點擊下一步

選擇「Xperia 手機或平板電腦」後點擊下一步，注意：至少要維持 80% 以上的電力喔！

這裡的提示訊息蠻嚇人的，現在小蛙需要重置就是因為要把手機清空，因為忘記螢幕鎖才使用這個方法，結果現在又需要 Google 帳號密碼，其實小蛙重置的流程並不需要再次確認 Gmail 帳號密碼，勾選「是，我知道我的 Google^TM 帳號詳細資料」後點擊下一步

等待初始化，這邊小蛙等了幾分鐘才進入下一步

確認以下事項：

• 請確認裝置已與電腦斷線
• 關閉裝置並稍等 5 秒鐘
• 請按住裝置上的降低音量鍵
• 仍按住鍵時，將裝置連結至電腦
• 等候應用程式自動執行至下一步驟

上述步驟都正確的話，會跳到以下畫面，注意所有資料都會被清除喔！勾選「我瞭解將會遺失個人內容」後點擊下一步

最後確認畫面，重置期間無法做任何動作，包含緊急通話，點擊下一步之後就開始重置了

重置中，注意千萬別讓手機此時斷線，不然可能會變成磚頭 (從前刷機刷壞，造成手機整台壞掉無法重開或做其他動作的狀況就叫磚頭)

重置完成！先將手機斷線，接著開啟手機，第一次開機會使用比較久的時間，到這邊就打完收工囉！

這篇文章 Sony Xperia 強制重置手機 最早出現於 記下來。

PHP 壓縮檔案

這邊是留給自己的 ZipArchive 用法的 memo，確定載入此模組後，只要使用以下方法就可以輕鬆把檔案壓縮成 zip

// 建立 ZipArchive 物件
$zip = new ZipArchive();
// 在指定路徑中建立一個 zip 檔
$res = $zip->open('tmp_callback/123.zip', ZipArchive::CREATE);
// 把 tmp_callback/file1 新增至 zip 內，並改名為 00000001.txt
$zip->addFile('tmp_callback/file1', '00000001.txt');
// 關閉 zip 物件
$zip->close();

透過網頁下載 zip 檔

透過以下的語法可以讓瀏覽器直接下載 zip 檔，一方面在之前做權限控管以及避免洩漏檔案真實路徑

$path = "/var/www/html/uploads/";
$filename = '03082358.zip';
	
header("Pragma: public");
header("Expires: 0");
header("Cache-Control: must-revalidate, post-check=0, pre-check=0");
header("Cache-Control: public");
header("Content-Description: File Transfer");
header("Content-type: application/octet-stream");
header("Content-Disposition: attachment; filename=\"".$filename."\"");
header("Content-Transfer-Encoding: binary");
header("Content-Length: " . filesize($path . $filename));
@readfile($file);

無法開啟壓縮檔的原因

直到有使用者反應壓縮檔無法開啟，透過 unzip-online.com 線上解壓縮也失敗

使用 notepad++ 開啟後才發現 zip 檔開頭有三行空白，可是有些電腦可以正常開啟有些電腦卻不行

只要把那三行空白刪除，就可以正常解壓縮了 …

無法開啟壓縮檔的解決方法

一開始以為是 ZipArchive 模組的問題，做了各種嘗試後發現，產出來的 zip 是正常的，並沒有上面那三行空白，那問題就是出在下載這段了。

試了很多方法發現只要有<?php include_once "xxx.php" ?>就會有三行空白的狀況，一開始笨笨的試著把所有用到的 include 都拔進來放，後來覺得這樣實在是又累又蠢，最後終於找到簡單解法 … 只要在readfile之前呼叫ob_clean();就可以避免這個問題 …

// 以上省略
ob_clean();
@readfile($file);

這篇文章 無法開啟 PHP ZipArchive 下載的 zip 檔 最早出現於 記下來。

小蛙收到的需求是要架設 FTP Sever ，建立一個特定使用帳號，並將該帳號的家目錄設定在特定路徑下，該文章完全符合小蛙的需求，照著做之後把過程中文化並記錄下來，開始吧！

安裝 vsftp

這邊使用較輕巧且設定簡單的 vsftp，透過以下指令進行安裝

sudo apt update
sudo apt install vsftpd

安裝完成後可輸入systemctl status vsftpd查看是否正常安裝及運作

設定 vsftp

vsftp 的設定檔在/etc/vsftpd.conf，小蛙這邊將進行以下 5 項設定，第 6 項傳輸加密部份因為沒有要用到，這邊就不另外提了。

sudo vim /etc/vsftpd.conf

1. 存取限制

設定禁止匿名者登入，以及本地帳號皆可使用

anonymous_enable=NO
local_enable=YES

2. 允許上傳

若要讓使用者上傳檔案，須將以下設定開啟

write_enable=YES

3. 限制目錄切換

基於安全性問題，想將使用者限制在特定區域，避免有心人士的非法行為，加上以下這兩項設定

chroot_local_user=YES
allow_writeable_chroot=YES

4. 被動連線 (PASV)

FTP Server 可以設定 (1) 主動模式 及 (2) 被動模式，在設定檔加入pasv_min_port及pasv_max_port兩個參數可限縮被動模式使用的 port 區間。

兩種模式各有優缺點，主動模式對伺服器來說比較安全，但對用戶端來說卻是可能帶來危險，因此很可能被用戶端的防火牆所阻擋了。使用被動模式雖然解決了用戶端的問題，但相對的伺服器必須開啟一定範圍的通訊埠供用戶端連線，好在目前絕大部分的 FTP 伺服器軟體，皆可以由管理者決定開啟哪些範圍的通訊埠。

FTP 主動模式與被動模式

pasv_min_port=30000
pasv_max_port=31000

5. 限制登入

除了上面設定的本機使用者可以登入外，也可以使用下面這些設定，僅讓清單上的使用者登入 FTP，我們將設定檔放在/etc/vsftpd.user_list內，檔案內一行為一個使用者帳號

userlist_enable=YES
userlist_file=/etc/vsftpd.user_list
userlist_deny=NO

6. 傳輸加密

小蛙這次設定沒有要用到，可參考原文進行設定。

設定防火牆

設定好 vsftp 之後，安全起見還是要把防火牆設定起來，FTP 需要開啟 port 20, port 21 以及上面設定的被動模式 port 區間

sudo ufw allow 20:21/tcp
sudo ufw allow 30000:31000/tcp

建立及設定 FTP 使用者

剛剛我們設定了只有/etc/vsftpd.user_list清單上的使用者才可以登入 FTP，現在就來新增一個 FTP 專用帳號

1. 新增使用者

使用adduser建立一個使用者 newftpuser (帳號換成自己要的)，並且把該使用者加入到允許登入清單中

sudo adduser newftpuser
echo "newftpuser" | sudo tee -a /etc/vsftpd.user_list

禁止 Shell 登入

由於只想讓該帳號使用 FTP 的功能，不希望該帳號透過 SSH 的方式登入進主機，新增一個名為 ftponly 的 Shell

echo -e '#!/bin/sh\necho "This account is limited to FTP access only."' | sudo tee -a  /bin/ftponly
sudo chmod a+x /bin/ftponly

將我們建立的/bin/ftponly加入到 shell 清單中

echo "/bin/ftponly" | sudo tee -a /etc/shells

接著把 newftpuser 的 shell 指定為/bin/ftponly

sudo usermod newftpuser -s /bin/ftponly

完成後如果嘗試使用該帳號登入 SSH，就會看到以下訊息 ~

打完收工！同場加映，因為小蛙還要重新設定使用者家目錄，透過以下指令即可完成。

sudo usermod -d /my/new/path newftpuser

這篇文章 Ubuntu 安裝及設定 vsftp 最早出現於 記下來。