上传文件是一个网页应用必不可少的一部分，这里就记录一下 Laravel 中如何上传，并展示图片。

拆分开来主要分为如下几个步骤：

• 创建数据库 Model，用一个 Model 实体来保存上传图片的路径以及相关的 meta 信息
• 添加 Controller 层用来处理保存图片逻辑，以及持久化的过程
• 创建前端 Form 表单，并提交 POST 请求，提交图片

创建数据库 Model

首先使用 artisan 创建一个 Model 和 migration:

php artisan make:model Photo -m

这行命令会创建一个数据库 Migration 文件，在 database/migrations 下：

然后修改 migration 文件，创建数据库 schema：

public function up()
{
    Schema::create('photos', function (Blueprint $table) {
        $table->id();
        $table->string('name');
        $table->string('path');
        $table->timestamps();
    });
}

上面的操作便是创建了一张表叫做 photos，其中包含了 id, name, path 和时间四列

执行数据库变更，会根据数据库的配置自动创建表：

php artisan migrate

Controller 上传逻辑

创建 route，打开 web.php:

Route::get('upload-image', [UploadImageController::class, 'index']);
Route::post('save', [UploadImageController::class, 'save']);

然后创建 Controller

php artisan make:controller UploadImageController

内容：

<?php
 
namespace App\Http\Controllers;
 
use Illuminate\Http\Request;
use App\Models\Image;
 
 
class UploadImageController extends Controller
{
    public function index()
    {
        return view('image');
    }
 
    public function save(Request $request)
    {
         
        $validatedData = $request->validate([
         'image' => 'required|image|mimes:jpg,png,jpeg,gif,svg|max:2048',
 
        ]);
 
        $name = $request->file('image')->getClientOriginalName();
 
        $path = $request->file('image')->store('public/images');
 
 
        $save = new Photo;
 
        $save->name = $name;
        $save->path = $path;
 
        $save->save();
 
        return redirect('upload-image')->with('status', 'Image Has been uploaded');
 
    }
}

store 方法就把图片保存到了 images 目录中。

为了安全起见，可以修改一下文件路径：

$filename= date('YmdHi').$file->getClientOriginalName();
$file-> move(public_path('public/Image'), $filename);

Blade View

在 resources/views 下创建 image.blade.php，其中最重要的 form 部分：

<div class="card-body">
    <form method="POST" enctype="multipart/form-data" id="upload-image" action="" >

        <div class="row">

            <div class="col-md-12">
                <div class="form-group">
                    <input type="file" name="image" placeholder="Choose image" id="image">
                @error('image')
                    <div class="alert alert-danger mt-1 mb-1"></div>
                @enderror
                </div>
            </div>

            <div class="col-md-12">
                <button type="submit" class="btn btn-primary" id="submit">Submit</button>
            </div>
        </div>     
    </form>

</div>

Laravel 提供了多种安装方式：

• 可以通过官方提供的 [[Laravel Sail]] 初始化环境，Laravel Sail 是一个轻量的命令行工具可以和 Docker 开发环境交互。这意味着如果要使用 Sail 本地需要安装 Docker 环境。
• 通过 [[Composer]] 安装，Composer 是一个 PHP 环境下的依赖管理器工具
• Laravel Installer

Laravel Sail

Sail 的核心是项目中的 docker-compose.yml 文件。

curl -s "https://laravel.build/example-app" | bash

cd example-app
 
./vendor/bin/sail up

设置 alias:

alias sail="bash vendor/bin/sail"

之后就可以直接使用 sail up 命令。

一旦应用启动之后，可以访问本地：http://localhost .

不过在这里，我不清楚为什么我本地的 80 端口始终无法访问，所以我只能按照 docker-compose.yml 中的配置，将 APP_PORT 修改成 8080 端口，才能正常访问到。

Laravel Sail 启动之后会自动拉取如下组件：

• [[MySQL]]
• [[Redis]]
• [[mailhog]]，mailhog 是一个本地开发测试的邮件服务器，非常方便在本地测试 SMTP
• [[meilisearch]]
• [[Selenium]]
• Laravel 应用本身

邮件

Laravel Sail 中包含的还包含一个邮件测试服务器 MailHog ，该服务用于在本地开发期间拦截应用发送的所有邮件并提供一个 Web 界面在浏览器中预览这些邮件信息，方便测试和调试。

    mailhog:
        image: 'mailhog/mailhog:latest'
        ports:
            - '${FORWARD_MAILHOG_PORT:-1025}:1025'
            - '${FORWARD_MAILHOG_DASHBOARD_PORT:-8025}:8025'
        networks:
            - sail

MailHog 的 SMTP 服务器的默认端口是 1025。

Sail 运行时可以通过 http://localhost:8025 访问 MailHog Web 界面。

Sail 相关命令

启动

sail up

重新构建：

sail build --no-cache

执行 php 命令：

sail php --version

Composer

如果本地电脑已经安装了 PHP 和 Composer，可以直接通过 Composer 来初始化 Laravel 项目。一旦项目创建了，可以使用 Artisan CLI 的 serve 命令启动 Laravel 本地开发服务器。

composer create-project laravel/laravel example-app
 
cd example-app
 
php artisan serve

Installer

还可以通过 Laravel 安装器来初始化项目：

composer global require laravel/installer
 
laravel new example-app
 
cd example-app
 
php artisan serve

注意，这里需要将 laravel 加入系统的环境变量。

• macOS: $HOME/.composer/vendor/bin
• Windows: %USERPROFILE%\AppData\Roaming\Composer\vendor\bin
• GNU / Linux Distributions: $HOME/.config/composer/vendor/bin or $HOME/.composer/vendor/bin

开发环境

当 Laravel 安装好之后，我本地使用 JetBrains 提供的 PhpStorm，然后安装了 Laravel Idea 插件，可以按照官网提供的方式来申请开源许可。

从上周开始和朋友进行一个以 21 天为一个周期的计划，每个人都制定了一个 21 天的目标，从计划到完成每一个步骤都计分，最后按照打分给每个小伙伴奖励或者惩罚。

所以我从我的计划列表中搜寻了一下大致看了一些 TODO，很多细碎的任务大都花不了一两天时间，所以就思考了一下有没有什么目标适合这个时间段，后来发现最近自建的一些项目好像都是用一个框架写成的，比如有一个可以自建的 PT 站 [[UNIT3D]]，比如非常轻量的论坛 [[Flarum]]，还有 [[Koel]] 一个在线的音乐播放器，还有很多很多。所以想来 21 天可以用来熟悉一下这个框架，也可以用来快速实现一些想法。所以就有了这个开篇。

什么是 Laravel

[[laravel]] 是一个 PHP 编写的 Web 框架，如果类比的话，那 Laravel 之于 PHP，就像 Spring 生态之于 Java。

目标

我学习 Laravel 的目标有两个：

• 至少可以看懂接触到的开源项目，如果有机会可以改动以满足自己的需求，比如 Flarum 的插件等
• 二来可以用 Laravel 来快速实现一些想法，之前用 Python Web，一直没有好好学前端，所以界面非常糟糕，所以这一次可以借着一起顺便熟悉一下 Laravel 的 Blade 模板引擎，以及 [[TailwindCSS]]，然后制作一个可以在线分享书单，并定时发送邮件的网站
  • 我平时用豆瓣使用比较多，我认为豆瓣中最最要的有两部分，一部分是其词条，另一部分是其用户，词条的存在可以让我不断的发现同导演同演员的其他作品，同作家的其他图书，而用户的存在可以让我以某一个话题发现同主题的内容，所以我非常喜欢豆列这个功能。
  • 然而豆瓣近两年的一系列行为让我非常不满意，删词条，不明理由封禁用户，让我非常不满意
  • 所以想借着学习 Laravel 的过程，实现一个简单的豆列
• 豆列的功能包含：
  • 用户可以用其来组织一个书单
  • 如果其他用户订阅了该书单，那么有电子书的情况下，每隔两周都会自动将书单内容发送到用户自定义的邮箱中

计划

学习计划非常简单，我提前看了一下 Laravel 的官方文档，非常详细，几乎包括了这个框架用户要了解的所有内容。所以我按照官网的组织结构，列了一些重点。

[[laravel 21天挑战计划]]

• 首先比较重要的就是搭建一个开发环境。
• 其次就是先上手使用，通过编码了解其工作原理，一次请求是如何在其中流转的
  • [[2022-03-28-laravel-file-upload]]

  • [[2022-03-29-laravel-send-email

    Laravel 学习笔记：发送邮件]]

  • [[2022-03-30-laravel-queue]]
• 在了解一定使用基础之后，去了解一些底层实现原理
  • [[Laravel 学习笔记 —— 服务容器]]
  • [[Laravel 服务提供器]]
  • [[Laravel Facades]]
• 最后是如何部署上线

学习资源

官方：

• 文档
• Laravel best practices

网站教程

• https://www.itsolutionstuff.com/ 这个网站提供类非常多的样例代码实现，像极了 Cookbook。
• https://laracasts.com/series/laravel-5-from-scratch 一个非常丰富的 Laravel 网站，可以先把基础内容看完，如果有进阶的需求可以订阅。
• https://code.tutsplus.com/courses/get-started-with-laravel-5 虽然 URL 上还是 Laravel 5，但实际内容以及更新，等阅读完官网的内容，作为补充

图书

准备和文档一起交叉阅读：

• [[Laravel: Up & Running: A Framework for Building Modern PHP Apps]]

视频

YouTube 上有非常多的视频，但我认为现阶段我只需要注重在官方文档即可。如果实在遇到无法实践的再寻求 YouTube，比如之前不知道怎么调试 PHP，找了半天文字材料都不行之后才去寻求视频，毕竟视频材料还是效率比较低的。

Warp 是一个 Rust 编写，使用 GPU 渲染的终端(terminal)应用。目标是提升开发者的效率。

最近 Warp 发布了新闻稿，筹集了 2300 万美元的资金全力用来构建这个终端。

它之前筹集了 600 万美元的种子轮融资，由 GV 领投，Neo 和 BoxGroup 参投。还筹集了 1700 万美元的 A 轮融资，由 Figma 的联合创始人兼首席执行官 Dylan Field 领投。由企业家主导的这一轮投资，其参与者包括 Elad Gil、LinkedIn 前首席执行官 Jeff Weiner 和 Salesforce 的联合创始人兼联合首席执行官 Marc Benioff。

Warp 想要解决的问题

简化配置

上手体验的过程也可以知道，Warp 基本上没什么配置，基本上所有的功能都是内建快捷键调用，对新手非常友好。

速度

早在之前的文章中我就 提到过 因为使用越来越多的 zsh 插件，导致每一次打开新的 Tab 终端都要有一个明显的停顿，虽然后来使用 zinit 优化了一下插件加载，但是还是会感觉到一小点的卡顿，希望 Warp 能解决这个问题吧。

通过终端自身的能力，可以精减掉一些 zsh 的插件。

更加智能

Warp 的创始人 Zach Lloyd 说过，走过任何一个开发人员的桌面，都会看到一个打开的终端，还有代码编辑器，VS Code 完成了代码编辑器的重新定义，Warp 就去重新定义终端。

Warp 内置的命令自动补全，还有尚且不是很完善的 AI 搜索都是朝着智能化的方向前进的。GitHub Copilot 已经让我非常惊讶其代码自动补全的能力，我相信 Warp 未来在 AI 自动补全方面也会令人耳目一新。

协作

Warp 的创始人在总结其过去 20 年的程序生涯的时候说过现存的终端存在的两个痛点：

• 难用
• 只能一个人用

想来和他自身作为 Google Docs 的开发有着非常大的关系。当前的任何桌面程序如果加上了多人协作都是一个非常大的想象空间。那为什么终端不行？

在 Warp 中用户可以共享自己的命令行，设置，和历史。

上手体验

可以点击 这里 下载体验。

登录不上问题

如果在国内，大概率会卡在登录的界面（在还没有开放 beta testing 的时候会卡在输入邀请码的界面）。

这个时候需要本地其一个 1080 端口的代理，然后使用代理来启动 Warp：

export HTTP_PROXY=http://127.0.0.1:1080
export HTTPS_PROXY=http://127.0.0.1:1080

/Applications/Warp.app/Contents/MacOS/stable

在 macOS 上推荐使用 Clash for windows 。

几个重要的快捷键

• ctrl + shift + r 可以从社区或者自定义的命令中搜索并执行长命令
• cmd + p 非常常见的 Command Palette，现在很多应用都使用这个涉及，我现在在用的 Obsidian 也是，可以调用出应用内置的命令
• ctrl + r 搜索历史
• cmd + d 切分窗口
• ctrl + cmd + t 用来切换主题！

更多的快捷键可以在设置中查看。

自动补全

Warp 自带了命令的补全，效果还不错。

Warp 提供了对于命令结果的快速复制，以及分享，点击 Share 可以非常轻松的把命令结果分享给别人。

比如对于我上面的 git --help 的结果可以到 这里查看

当然如果没有 Warp，我会在 Tmux 中用 Tmux 的复制粘贴来实现这个需要。

存在的问题

• 一个终端竟然需要登录！当然我能理解这样的一个商业模式，毕竟这款终端可能未来会商业化，向用户收费，但如果要让我付费，可能我会去看看其带给我的体验是不是要好过目前的方案。并且前期在测试阶段为了不扩大 bug 可能产生的负面影响，所以在有限人群内测试都是可以理解的。
• 隐私问题，就像评论中指出来的那样，Warp 集成了 Telemetry，并且也被指责收集过多用户数据。
• Warp 破坏掉了我之前的 fzf 的一些操作，比如我之前设定 fe 就是 fuzzy find 当前目录，然后输入模糊搜索词，回车之后就会立即用 vim 编辑，但是在 Warp 中并不能用 fzf。

当然这可能和 fe 使用的 zsh 脚本有关系，有时间再看看怎么解决。

which fe
fe () {
    local files
    IFS=$'\n' files=($(fzf-tmux --query="$1" --multi --select-1 --exit-0))
    [[ -n "$files" ]] && ${EDITOR:-vim} "${files[@]}"
}

总结

Warp 不需要用户查看文档也可以有一个不错的上手体验，更不像其他终端那样需要一个非常复杂的配置文档才能将其调教得比较好用。

如果你看完这篇文章觉得 Warp.dev 还不错，可以点击 我的邀请1 或 邀请2 来尝试一下。

相关联终端

• 在 macOS 上我一直都用的 kitty 这样一款终端，通过简单的配置，日常用起来目前还没有遇到比较大的问题，配合 zsh, tmux 还算得上顺手
• [[Mac 应用 iTerm2]] 是一款比较正统的终端
• [[Mac 应用 alacritty 终端]] 也是一款 GPU 加速终端
• [[hyper.is]] 一款基于 Electron 的终端
• [[wezterm-terminal]] 是另一款 GPU 加速的终端，用 Rust 和 Lua 编写的，轻度体验了一下确实比较快，但是最近还没来得及深度体验。
• fig.io 是一款可以嵌入到其他 IDE 内部使用的终端，也实现了命令的自动补全等等功能。

reference

• https://docs.warp.dev/
• https://www.warp.dev/blog/fantastic-terminal-programs-and-how-to-quit-them-2

一台新的 Ubuntu 服务器通常时区可能不是想要的时区，可以通过如下步骤设定时区。

检查当前时区，在命令行下输入 date:

date

可以查看当前的时间。

输入 timedatectl 可以查看更具体的时区。

使用 timedatectl

修改为东八区北京时间。

sudo timedatectl set-timezone "Asia/Shanghai"

ln

也可以通过软链接来修改系统的时区，在 Linux 下 /etc/localtime 中定义了系统要使用的时区。正确的配置在 /usr/share/zonefine 目录中

mv /etc/localtime /etc/localtime-backup
ln -s /usr/share/zoneinfo/Asia/Shanghai /etc/localtime

修改完成后可以通过 timedatectl 来验证。

DMARC 是 Domain-based Message Authentication Reporting & Conformance 的缩写，是一个标准的电子邮件验证标准。¹ DMARC 帮助邮箱管理员防止黑客或其他攻击者伪装（Spoofing）其组织和域名。Spoofing（伪装）是一种电子邮件攻击方式，攻击者通过伪装邮件地址中的 From 字段，来假装发件人。DMARC 会检查电子邮件是否来自邮件中声称的发送者。

DMARC 构建在 [[SPF]] 和 [[DKIM]] 基础之上，来防止域名欺诈。

之前提到过自建域名邮箱 的文章中就配置过 DMARC，这篇文章就对 DMARC 具体展开讲讲。

DMARC 是什么？

DMARC 建立在广泛使用的 SPF 和 DKIM 协议上, 并且添加了域名对齐检查和报告发送功能。这样可以有效保护域名免受钓鱼攻击。

来自 dmarc.org 的示意图：

为什么 DMARC 如此重要？

根据 dmarc.org 的说法：

随着社交网络和电子商务的繁荣，垃圾邮件发送者和钓鱼攻击发起者基于利益的原因，想要入侵用户的账户，破解用户的信用卡等。Email 的相对容易攻击的特性备受罪犯们的青睐。只是简单地把企业的 logo 嵌入到 email 中，就能获取用户的信任。

用户很难辨别一封假的 email，邮件提供商也很难判断哪些邮件有可能会伤害用户。邮件发送者基本上对邮件认证的问题一无所知，因为他们缺少合理的反馈机制。那些尝试部署 SPF 和 DKIM 的企业的进展非常慢，因为没有监督进度和除错的机制。

DMARC 解决了这些问题。它帮助 email 发送者和接收者来共同保护 email，避免了昂贵的入侵损失。

DMARC 记录是什么？

DMARC 记录作为 TXT 记录发布到 DNS 中。指示邮件收件服务当验证失败时，应当如何处理收到的邮件。

比如以下发布在域名 “sender.exampledomain.com” 上的 DMARC 记录：

v=DMARC1;p=reject;pct=100;rua=mailto:postmaster@exampledomain.com

在这个例子中表示发件人要求收件人如果遇到验证未通过的邮件，则完全拒绝，并且发送相关报告到 postmaster@exampledomain.com。如果发件人在测试配置，”reject” 可以被替换成 “quarantine”，表示验证未通过的 邮件将被隔离。

DMARC 记录标签

DMARC 记录使用可扩展的 “标签-值” 语法。

这是一个典型的 DMARC 记录：

v=DMARC1; p=none; rua=mailto:dmarc_report@example.com; ruf=mailto:dmarc_report@example.com; pct=100; adkim=s; aspf=s;

它由多个 key-value 标签组成。这些标签会告诉邮件服务提供商如何发送 DMARC 报告:

• v  是 DMARC 协议版本，它的值必须是  DMARC1
• p  是策略，策略将被应用到验证失败的邮件上,可以设置成 ‘none’, ‘quarantine’, 或者 ‘reject’
  • ‘none’ 如果接收服务器接收到的邮件没有通过 DMARC 校验，不会做任何操作，邮件会正常被递交
  • ‘quarantine’ 用来隔离可疑邮件，如果接收服务器收到的邮件没有通过验证，那么会把邮件单独隔离
  • ‘reject’ 告诉接收方拒收可疑邮件
• rua  是一组用来接收报告的电子邮件地址(DMARC aggregate)
• ruf  是一系列用来接受失败报告的电邮地址(DMARC failure)
• pct  对失败邮件应用策略的百分比
• adkim  制定 DKIM 的对齐策略，可选 s 或 r
• aspf  制定 SPF 的对齐策略，可选 s 或 r

如果不想配置报告失败的邮箱，可以

v=DMARC1; p=none;, p=reject;, p=quarantine;

DMARC 策略

DMARC 策略是在 DMARC 记录中制定的 p 标签。它指示邮件服务提供商应该如何处理验证失败的邮件。

DMARC 策略可以取三个值中的一个：none (monitor), quarantine  和  reject。

– none: 邮件提供商对验证失败邮件不采取任何处理。这个模式用来收集 DMARC 报告。 – quarantine: 邮件提供商把验证失败邮件放到垃圾邮件文件夹。 – reject: 邮件提供商拒收验证失败邮件。

DMARC alignment options

DMARC 对齐策略。DMARC 通过检验 header 部分是否和发送的域名相匹配，这个动作称为 alignment，这个部分验证依赖 SPF 和 DKIM。

用户可以在 DMARC 中配置两种 alignment 模式，strict 和 relaxed。上面提到的 aspf 和 adkim 选项就是这个作用。s 和 r 分别是两个缩写。

Envelope sender address: 是 Return-Path 头的邮件地址，收件人是看不到该地址的

From: 地址，收件人看到的地址

SPF alignment example

DKIM alignment example

DKIM signature domain 中的 d= 后面部分。

发布 DMARC 记录

发布 DMARC 记录需要你有权限修改域名的 DNS 记录。

在 DNS 记录后台，需要创建一条 DMARC 记录。

创建一条 TXT 记录:

Type: TXT Host: _dmarc TXT Value: (DMARC record generated above) TTL: 1 hour

以 Cloudflare 后台为例：

如果用其他的域名服务的话，界面类似。

保存更改。现在你已经在域名 yourdomain.com 上面成功发布 DMARC 记录了。

如果不知道怎么写 DMARC 记录也可以在这个网站 通过表单的形式生成。

reference

• https://support.google.com/a/answer/10032169?hl=en&ref_topic=2759254
• Getting Started with DMARC

常见的语句：

• condition，条件
• for-loop，循环
• goto，跳转（特殊）

statement vs expression

下文中使用 statement 和 expression 来表达一些语句的区别：

• statement, 通常用来指代一个操作，可以是赋值操作，等等
• expression 通常用来指代一个值，这个值可以是一个语句的返回，也可以是一个函数的返回

条件语句

通用：

if InitSimpleStatement; Condition {
    // do something
} else {
    // other
}

• 和其他语言一样 else 是可选的
• InitSimpleStatement 是可选的，必须是 Simple Statement，通常这部分是一个简单变量的定义或者赋值
• Condition 必须是一个返回值是 boolean 值的 expression，这部分可以添加 () 或者不加。
• 如果没有 InitSimpleStatement，那么后面的 ; 也是可选的

举例：

if a < 4 {
    return 0
} else {
    return 1
}

更复杂一些的：

package main

import (
    "fmt"
    "math/rand"
    "time"
)

func main() {
    rand.Seed(time.Now().UnixNano())

    if n := rand.Int(); n%2 == 0 {
        fmt.Println(n, "is an even number.")
    } else {
        fmt.Println(n, "is an odd number.")
    }

    n := rand.Int() % 2 // this n is not the above n.
    if n % 2 == 0 {
        fmt.Println("An even number.")
    }

    if ; n % 2 != 0 {
        fmt.Println("An odd number.")
    }
}

switch-case

一种特殊的条件分支语句。

switch i {  
case 0:  
   fmt.Printf("0")  
case 1:  
   fmt.Printf("1")  
case 2:  
   fmt.Printf("2")  
case 3:  
   fallthrough  
case 4, 5, 6:  
   fmt.Printf("4,5,6")  
default:  
   fmt.Printf("Default")  
}

for loop

for 循环的格式：

for InitSimpleStatement; Condition; PostSimpleStatement {
    // do something
}

• for 循环的语法和其他语言相差不多，但不需要 ()

for i := 0; i < 10; i++ {
    fmt.Println(i)
}

几个变种：

var i = 0
for ; i < 10; {
    fmt.Println(i)
    i++
}
for i < 20 {
    // do something
    i++
}
for i := 0; ; i++ {
    if i >= 10 {
        break
    }
}

使用 for range 遍历 map:

for key, value := range oldMap {
    newMap[key] = value
}

goto 跳转语句和 Label 定义

Java 语言不支持 goto 关键字，但是 goto 是作为关键字保留了下来，但是 Java 中可以使用 label 关键字来达到 goto 的效果。

Go 语言支持 goto statement，goto 关键字必须跟一个 label 来表达跳转到的地方。

package main

import "fmt"

func main() {
    i := 0
Here: // declare a label
    fmt.Println(i)
    i++
    if i < 10 {
        goto Here // goto label
    }
}

需要注意的是 label 对于最里层的代码块是不可见的。

break 和 continue 关键字后面都可以接 label

defer 关键字

defer 关键字会推迟方法的执行，知道外层的方法返回之后再执行。

defer 的调用的参数会立即

A defer statement defers the execution of a function until the surrounding function returns.

The deferred call’s arguments are evaluated immediately, but the function call is not executed until the surrounding function returns.

package main

import "fmt"

func main() {
    defer fmt.Println("world")

    fmt.Println("hello")
}

reference

• https://github.com/go101/go101

最近收到 Oracle(甲骨文) 一封名为「Oracle Cloud Infrastructure Compute - Resource Maintenance Reminder」 的邮件，大致意思就是如果 Oracle Always Free 的机器使用率比较低的话，Oracle 就会判定 Compute Instances 处于 Idle (闲置)状态，Oracle 将保留回收实例的权力。

如何判定机器是处于闲置状态呢，在 Oracle 给出的官方文档 是这样描述的：

• CPU utilization for the 95th percentile is less than 10% ，95% 时间 CPU 利用率低于 10% • Network utilization is less than 10% ，网络利用率低于 10% •Memory utilization is less than 10% (applies to A1 shapes only)，内存利用率低于 10%（仅适用于 A1 类型的 ARM 实例）

Oracle 给出的描述非常清晰，就目前我的理解，应该是只要上述三个条件中的一个满足了就会触发 Oracle 的回收机制，首先 Oracle 会发送一封警告邮件 Action Recommended，标题就是上面的。然后会告知用户，7 天之内如果没有满足上述标准就会回收实例。

Oracle Cloud Infrastructure Customer,
Oracle Cloud Infrastructure (OCI) will be reclaiming idle Always Free compute resources from Always Free customers. Reclaiming idle resources allows OCI to efficiently provide services to Always Free customers. Your account has been identified as having one or more compute instances that have been idle for the past 7 days. These idle instances will be stopped one week from today, January 30,2023. If your idle Always Free compute instance is stopped, you can restart it as long as the associated compute shape is available in your region. You can keep idle compute instances from being stopped by converting your account to Pay As You Go (PAYG). With PAYG, you will not be charged as long as your usage for all OCI resources remains within the Always Free limits.

解决方案

因为我之前申请的两台 AMD 和一台 24 G 内存的 ARM，都不敢将生产的东西放在上面，怕得就是 Oracle 突然变卦，所以上面跑的程序都比较少，现在看起来 Oracle 至少在变卦之前还是会发出声明的，可以将一些 Docker 迁移到机器上跑跑了。

解决方案其实也比较简单，一个就是按照官网所提供的方式升级成付费账号，用多少支付多少（Pay As You Go (PAYG)）；另外一个方案就是真实地把机器利用起来，跑一些程序，或者将起作为 [[k3s]] 节点加入集群跑起来，看看满足其使用的最低要求。

说实话，网上有一些教程让用户禁用 oracle cloud agent（root 模式下执行 snap remove oracle-cloud-agent），禁止 Oracle 监控实例的运行状况。因为可以猜测的就是 Oracle 会在 VM 实例中跑监控程序，然后批量地监控用户机器的使用情况，包括 CPU，内存，网络等等，如果把这个 agent 卸载掉了是否 Oracle 就检测不到了。说实话我是不推荐这个方法的，因为 VM 运行在 Oracle 的机房，要检测还是能通过其他手段来检测到的。

所以个人还是推荐将 VM 好好利用起来，个人在过去尝试过的 Self-hosted 应用，非常不错的都在这里 管理了起来，也可以在 GitHub Awesome Self hosted 项目里面找找自己感兴趣的利用起来。

利用 lookbusy 生成虚拟负载

lookbusy 是一个可以虚拟产生 CPU、内存、磁盘等负载的工具。

lookbusy 常用的一些使用方法。

CPU 使用

• -c： 每个 cpu 的期望利用率，以百分比为单位（默认 50 ）。若选择 curve 使用模式，则应给出 MIN-MAX 形式的范围。
• -n：保持忙碌的 CPU 数量（默认值：自动检测出的全部核心数）
• -r： 第一种模式：fixed，保持指定百分比的 CPU 利用率，第二种模式：curve，CPU 利用率随给定区间上下浮动。
• -p： 曲线内峰值利用率的偏移量，默认单位是秒，可以添加 m、h、d 作为其他单位
• -P： 曲线内峰值利用率的偏移量，可以添加 m、h、d 作为其他单位

内存使用

• -m： 以字节为单位，后面是 KB、MB 或 GB（其他单位）
• -M： 单位为毫秒（默认值为 1000）

磁盘使用

• -d：用于磁盘流失的文件大小（以字节为单位，后跟 KB、MB、GB 或 TB（其他单位））
• -b：用于 I/O 的块大小（以字节为单位，后跟 KB、MB 或 GB）
• -D：迭代之间的休眠时间，以毫秒为单位（默认值为 100）
• -f： 要用作缓冲区的文件 / 目录的路径（默认 /tmp）

使用举例：

lookbusy -c 50 # 占用所有 CPU 核心各 50%
lookbusy -c 50 -n 2 # 占用两个 CPU 核心各 50%
lookbusy -c 50-80 -r curve # 占用所有 CPU 核心在 50%-80% 左右浮动
lookbusy -m 128MB -M 1000 # 每 1000 毫秒，循环释放并分配 128MB 内存
lookbusy -d 1GB -b 1MB -D 10 # 每 10 毫秒，循环进行 1MB 磁盘写入，临时文件不超过 1GB
nohup lookbusy -c 50 -D 10 > /dev/null 2>&1 & #占用所有 CPU 核心各 50%，且后台运行，不记录日志

在 Oracle ARM 机器上可以直接使用 docker-compose 启动。

Koel 是著名的个人音乐在线播放与电台程序。

Prerequisite

• 硬件要求：一台最低内存为 1G 的服务器
• 系统：Ubuntu20.04 LTS，或其他任何 Linux 发行版
• 数据库：MySQL，MariaDB，PostgreSQL，SQLite
• 一个域名

基础架构

Koel 后端使用 Laravel PHP 框架，前端使用 Vue，还使用了 SASS 的 CSS 框架。数据库使用 MariaDB（MySQL）。

Docker 安装

使用 Docker compose:

version: '3'

services:
  koel:
    container_name: koel
    image: hyzual/koel
    restart: always
    ports:
      - 8081:80
    environment:
      - DB_CONNECTION=mysql
      - DB_HOST=${DB_HOST}
      - DB_USERNAME=${DB_USERNAME}
      - DB_PASSWORD=${DB_PASSWORD}
      - DB_DATABASE=${DB_DATABASE}
    volumes:
      - ${MUSIC_PATH}:/music:ro
      - ${COVERS_PATH}:/var/www/html/public/img/covers
      - ${SEARCH_INDEX_PATH}:/var/www/html/storage/search-indexes

安装完成后进行初始化：

docker exec -it <container_name_for_koel> bash
php artisan koel:init --no-assets

从 v5.1.0 开始 Koel 不会在安装的时候去设置 admin 账户，会使用一个默认的用户名：

email: admin@koel.dev
password: KoelIsCool

可以通过界面重置密码，或者执行命令：

docker exec -it <container_name_for_koel> php artisan koel:admin:change-password

当前的 Koel 可识别这些音频扩展：.mp3，.ogg，.m4a（实验）和 .flac

快捷键

也有几个快捷键呀：

• F：移动到搜索框
• Enter：播放一首歌曲。如果有多首歌曲被选中，Enter 将它们添加到播放队列的底部，Shift+Enter 将它们排到顶部。在组合中加入 Cmd 或 Ctrl，可以立即播放第一首被选中的歌曲。
• Space：切换播放/停止
• J：播放队列中的下一首歌曲
• K：播放队列中的上一首歌曲
• Ctrl/Cmd+A：选择当前视图中的所有歌曲
• Delete：从当前队列/播放列表中删除所选歌曲

reference

• [[online-music-stream]]
• https://qing.su/article/personal-music-streaming-server-with-koel.html
• https://www.eluyee.com/koel/

在逛 Twitter 的时候看到有人分享了一款 Launcher，叫做 [[Raycast]]，因为平时一直使用 [[Alfred]] 倒是没有引起我的太多注意，但今天又看到了一次，所以就想好好来了解一下这个新出来的启动器。

在 macOS 上其实有非常多的启动器，包括了系统默认的 [[Spotlight]]，以及很多第三方应用，包括了 [[Alfred]], [[LaunchBar]] 在内的无数优质应用。这些应用有着各自的特点。但最重要的一点就是提高我们打开应用的速度，以及在各个小细节方面提高易用程度，比如我最喜欢的 Alfred 的一个贴心功能就是历史粘贴板，在 Linux 上我一直都是用的 [[fcitx]] 默认的快捷键 Ctrl+;，所以在 macOS 也用一样的快捷键。

安装

安装：

brew install --cask raycast

特性

• 最基本的功能，启动 macOS 上的应用，搜索文件
• 历史粘贴板
• 搜索打开书签
• 集成第三方应用
  • 在 GitHub，Jira 等等中创建、搜索、关闭 issues
  • 批准、合并和关闭 GitHub Pull Request
  • 调用 Zoom 会议
• 支持快捷键设置日程、待办事项
• 支持扩展脚本

使用

Auto-expand Snippet

写过代码的人应该对 Snippet 非常熟悉，我们可以定义一些常用的代码块，然后通过简单的几个字母来快速补充一段内容。

在 Raycast 中，可以通过输入 Create snippet 来创建 Snippet，在弹出的设置窗口中输入想要设置的内容。

注意下面的 Keyword, 输入 Keyword 的内容就是唤起整个 Snippet 的快捷键。

比如当我输入 :blog 的时候就会自动补全成https://blog.einverne.info

如果有读者记得的话，我在不就之前介绍过一款跨平台的 Text Expander —- Espanso，也能够做到相同的事情。有兴趣可以查看espanso：Rust 编写的跨平台开源文本扩展工具。

Clipboard History

在 Raycast 中输入 Clipboard History 可以打开粘贴板历史。

这里值得注意的是 Raycast 所有数据都是本地加密存储，所以可以不用担心粘贴板的隐私问题。

同样，在应用设置中，可以设置快捷键，我就设置成和 Linux 下一致的 Ctrl+;

File Search

在 Raycast 中输入 f 可以看到 File Search，授权 Raycast 搜索本地文件之后，就可以直接在 Raycast 中根据文件名一键搜索到。

Define Word

在 Raycast 中输入 dw 就可以看到 Define Word 的选项，这个可以用来查单词。

Switch Windows

在 Raycast 的扩展中有一个 Switch Windows 的插件，可以设置一个快捷键，比如 Option + Tab，这样就可以快速调用出窗口切换功能，直接输入关键字 Enter，就能切换窗口，再不用 Cmd + Tab 来换切换了。当然可以根据自己的需要设置成任意的快捷键。

Search Screenshot

Raycast 支持直接搜索图片中的内容，还可以选中图片之后使用，cmd + Shift + a 使用 Cleanshot 对图片标注。

Store

输入 Store 可以打开 Raycast 的商店，然后可以在其中安装、启用非常多的三方插件。

目前Raycast已经接入了 GitHub、Jira、G Suite、Linear、Asana、zoom，Notion，Things，Raindrop，Todolist 等服务，能够快速完成特定操作。

Browser Bookmarks

首先在 Store 中安装 Browser Bookmarks

然后在设置中启用 Chrome：

注意选择正确的 Profile。

然后就可以在 Raycast 中输入 Browser Bookmark 来搜索 Chrome 的书签了。

不过需要注意的是，只有书签存在中文、英文才能被搜索出来，如果书签没有描述，或者你忘记了域名，那么也是无可奈何的。

悬浮标签 Floating Notes

在 Raycast 中输入 Floating Notes 之后就会在桌面最顶层开启一个悬浮便签，便签可以移动位置，但是永远在所有窗口的最上面。非常方便用来记录快速的想法，待办事项等等。

在输入 Float 之后，有两个选项：

• Toggle Floating Notes Focus，这个选项会将光标移动到便签中
• Toggle Floating Notes Windows 会显示隐藏便签窗口

日程管理和待办事项

Raycast 可以直接连接 Calendar，因为我的 macOS 上的日历同步了 Google Calendar 的数据，所以可以直接看到我的日程。

在 Raycast 中输入 My Schedule 即可。第一次可能需要授权。

同样可以输入 reminder 来查看待办事项，或者根据提示来创建待办事项。

系统设置

比如输入 volume 可以调整音量。

其他比如计算器、汇率转换、时间查询等等基础功能就不再展开。

如果有时间会再讲讲如何在 Raycast 中执行自定义脚本，或者如何编写自己的扩展。 Raycast 支持的脚本语言，Bash、Swift、AppleScript。

related

• [[Alfred]]
• [[LaunchBar]]
• [[HapiGo]]
• Raycast 相关脚本